用途:在修改 docs/ 目录或任意 *.md 文件时使用的文档更新工作流,强调 SSOT(单一事实来源)意识。前置要求:分支、提交与 PR 流程使用 git-workflow 技能;编辑文档前先理解 SSOT 结构。
主要能力:编辑前需判断文件本身是否为 SSOT 或引用了某个 SSOT。SSOT 位置包括 AGENTS.md(智能体行为入口)、docs/ai/design.md(指令系统设计)、docs/guidelines/task-classification.md(标签定义)、.claude/skills/label-context-mapping/(标签到技能映射)、docs/guidelines/coding-conventions.md、security.md、testing.md、workflow.md。规则:编辑 SSOT 文件需谨慎,因其他文件引用它;编辑非 SSOT 文件应引用 SSOT 而非复制信息;信息冲突时以 SSOT 为准并更新引用文件。
适用文件:AGENTS.md、ARCHITECTURE.md、docs/guidelines/ 为 SSOT;docs/design/、docs/chains/ 为参考;docs/ai/task-contexts/ 为上下文;internal/AGENTS.md、pkg/AGENTS.md 为局部 SSOT。
使用方式:先识别文档类型与受影响文件,检查是否重复信息,按 Markdown 风格修改(ATX 标题、段落间空行、代码块标注语言、表格、相对链接),再验证交叉引用。自检清单包括 SSOT 定位、无重复信息、引用正确、渲染正常、链接有效、格式一致、表格对齐。提交使用 git-workflow,提交类型为 docs,示例:docs(standards): update coding conventions for error handling。
限制:资料未提供该技能的具体安装命令、收费方式或平台支持信息。