Repository navigation
docs: add categorized mcpp API skills for coding agents #876
Description
背景
希望为使用 AI agent 的 mcpp 用户和贡献者提供按任务组织的使用指南，
覆盖命令、mcpp.toml 配置和公开程序接口，减少使用过程中反复查找文档、
遗漏配置作用域或误用接口的情况。
目前已经准备了一份本地草稿，希望将其贡献到项目中。
提议内容
在 .agents/skills/mcpp-api-skills/ 下集中管理技能集，包含：
- 9 个分类、34 个聚焦具体任务的技能。
- 英文技能正文和参考资料。
- 英文及简体中文 README 导航。
- 命令、配置项和公开 API 的接口索引。
- 源码声明检查、结构检查和运行时验证工具。
- 贡献指南中关于同步维护受影响技能的说明。
准确性与验证
初始源码核对基线为 mcpp 2026.10.31.3，
提交 ce4dd4b。
内容核对同时参考源码实现，未仅依据现有文档。
消费项目的实际反馈也用于复核 include 路径、
工具链 configure 配置和测试发现等说明。
源码审阅、语法检查和实际运行验证会分别记录。
没有运行的环境和功能不会写成已经验证。
目录与维护方式
将套件集中放在一个目录内，便于在当前仓库中维护；
如果维护者倾向独立仓库，也便于后续迁移。
希望讨论目录位置、分类方式，以及公开接口变化时同步更新技能的维护安排。
Activity
skyler-zbt commentedon Oct 31, 2026
对应实现已提交至 PR #879：
PR 包含分类技能集、接口索引、验证工具和同步维护说明，
具体变更、验证结果及尚未覆盖的范围已在 PR 中说明。
目录组织、内容范围和维护方式可以继续在 PR 中讨论，
后续会根据审阅意见调整。
Sunrisepeak commentedon Oct 31, 2026
已经有相关skill 了
skill 不用分这么细, 和 docs 文档重复了
skyler-zbt commentedon Oct 31, 2026
感谢反馈，理解项目需要避免 skill 与 docs 重复维护。
我最初考虑的是，mcpp-usage 偏向入门和常用操作，部分复杂场景的流程比较简略，因此参考了 xmake-skills 按任务组织的方式，并对照源码核对行为，希望补充 agent 执行任务时需要注意的边界和验证步骤。
核对源码并做隔离验证时，也发现几处可以完善的流程提示，例如：
新稿补充了这些步骤，不过确实也展开成了另一套较完整的接口参考，增加了重复维护的内容。
如果目前的组织方式不适合项目，我可以将贡献收敛为对现有 mcpp-usage 的少量完善，只补充任务流程、作用域提醒和验证步骤，详细参数及 API 继续引用 docs。
请问更希望我按这个方向调整当前 PR，还是现阶段不需要继续处理这方面的改动？
Sunrisepeak commentedon Nov 1, 2026
mcpp-useage 是最小SOP + 文档索引, 现在AI的能力已经不需要复杂的agent skills, 基本给ai仓库链接 即可 当成知识库来用