本技能用于指导智能体为库、SDK 或 package 生成供 AI 使用的文档型技能,解决大模型对企业私有库或小众开源项目使用不准确的问题。
用途:创建专供 AI 使用的库操作手册,帮助其准确、高效地使用该库。当库代码更新、用户提出创建或更新技能时触发。
硬约束:事实来源须来自公共导出、类型声明、源码、测试、示例、README、CHANGELOG,禁用训练数据或猜测补齐;仅收录公共 API,排除 internal、private 及标注 @internal / @private 的符号;采用渐进披露,SKILL.md 保持精简,细节放入 references/ 或 packages/;技能用中文撰写,专有名词与标识符可保留英文;禁止写入内部实现细节。
工作流分三类:新增(分析源码测试文档、确认技能名称、规划结构、创建目录与 SKILL.md,再验证);更新(先校验规范,必要时重写,否则对比库版本与技能「版本」章节,按更新内容调整并同步精确版本,再验证);一致性校验(用子代理全量检测源码与技能一致性,含版本对齐,输出通过或差异报告并让用户决策)。
输出落点默认为 skills/<skill-name>/。SKILL.md 含 name(kebab-case,不超过 32 字符)与 description(不超过 512 字符,含做什么与何时使用),并包含版本、模块地图、路由决策、检查清单等章节;不得超过 500 行,200 行内最佳。验证项包括描述含触发词、每个 references 文件有路由路径、示例仅用公共 API 且版本一致。API 说明优先用类型声明代码块。反模式包括单文件塞整本手册、每函数一个技能、示例用内部路径、用过时知识、库变更不更新技能等。具体安装命令与收费信息暂未提供。