cpp-agentic-development-frame
一个为C++智能体开发设计的CMake项目框架与技能集合。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：cpp-agentic-development-frame。 它的用途是：一个为C++智能体开发设计的CMake项目框架与技能集合。 完整的 Skill 内容见：https://321skill.com/skills/cpp-agentic-development-frame/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请参考cpp-agentic-development-frame框架的AGENTS.md契约，为我的新C++数据处理库创建一个特性记录，并规划初始的CMake结构和测试用例。”，它会引导你按照框架的规范，在feature_records/planned/目录下创建结构化的记录文件，并生成符合契约的CMakeLists.txt和测试文件模板。或者，在开发过程中，你可以指示AI：“调用项目本地的‘代码审查’技能，检查src/core/processor.cpp文件的合规性。”
介绍
这个项目旨在解决C++智能体开发中项目结构混乱、工具链不统一、开发流程不规范的问题。它提供了一个基于CMake的完整项目框架，内置了库、CLI示例、确定性测试、文档工具链以及一套专为项目本地化设计的智能体技能（位于.agents/skills/目录下），帮助开发者快速搭建一个标准化、可维护的C++智能体项目。
使用上，开发者可以通过CMake预设（如dev, release）快速配置和构建项目。框架的核心是AGENTS.md文件，它定义了项目与编码智能体之间的契约，确保所有开发活动（如编码、测试、发布）都遵循统一的规则。项目内置的技能覆盖了编码、文档、规划、安全、发布等多个方面，可以直接调用或作为模板进行适配。
它非常适合希望采用标准化、契约化方式进行C++智能体开发的团队或个人，特别是那些重视代码质量、测试覆盖率和自动化流程的开发者。对于需要将AI智能体深度集成到C++开发工作流中的项目，此框架提供了清晰的路径和工具支持。
建议用户首先阅读AGENTS.md以理解项目契约，然后从Quick Start开始体验。由于框架预设了多种构建配置（如带消毒器的调试版、带LTO的发布版），请根据开发阶段选择合适的预设。框架默认不依赖Qt，但为UI项目提供了可选的集成示例。
核心特点
与通用C++项目模板不同，它深度集成了面向智能体开发的契约（AGENTS.md）和一套项目本地的智能体技能，将AI协作流程正式化、工程化。同时，它强制要求测试附带WHAT/HOW/WHY注释，并通过“特性记录”文件夹（feature_records/）显式管理功能生命周期，提供了远超普通脚手架的项目治理能力。
注意事项
不适合只需要一个简单C++项目启动模板，而不需要复杂智能体契约和本地技能集成功能的开发者。
常见问题
这个框架和普通的CMake模板有什么区别？
核心区别在于它内置了与AI智能体协作的正式契约（AGENTS.md）、一套项目本地技能库，以及强制性的测试注释和特性记录生命周期管理，旨在规范化和工程化AI辅助的开发流程。
我必须使用Qt吗？
不需要。框架默认是便携的C++23库+CLI，Qt/Clazy支持是作为可选示例提供给需要添加UI层的项目。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/cpp-agentic-development-frame/raw/index.md 读取 cpp-agentic-development-frame 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/cpp-agentic-development-frame/raw/index.md（查看排版版本）