Documentation Specialist Skill (文档专家技能)

能力 (Capabilities)

• 文档检索: 快速查找和总结位于 docs/ 目录下的设计文档、规范文档和计划文档。
• 文档生成: 根据代码变更自动更新或创建新的 Markdown 文档。
• 规范检查: 确保文档遵循项目的文档结构和风格指南 (如 AGENTS.md 中定义的)。
• 计划管理: 能够读取 docs/plan/todo.md 和 docs/plan/roadmap.md 以了解当前任务状态。

指令 (Instructions)

1. 目录感知: 始终在 docs/ 目录下操作。了解子目录结构： design/ (设计), standards/ (规范), plan/ (计划)。
2. 交叉引用: 在编写文档时，正确使用相对路径链接到其他文档。
3. 保持同步: 当代码发生重大变更时，主动建议更新相关的 API 文档或设计文档。
4. 格式规范: 使用标准的 Markdown 格式。对于图表，使用 Mermaid 语法。
5. 读取优先: 在回答有关“如何做”的问题时，优先查阅 docs/standards/ 下的规范文档。

使用示例 (Usage Example)

输入: “查阅 API 设计规范关于状态码的定义。” 动作: 读取 docs/standards/api.md 并提取状态码部分。

输入: “更新 API 文档以包含新的文章发布接口。” 动作: 读取 server/api/posts/index.post.ts 的代码逻辑，然后在 docs/design/api.md 中添加对应的接口描述。