# Documentation Specialist > 专注于查阅、维护和生成项目文档 (位于 docs/ 目录下)。 Use when this capability is needed. - Skill: `tomevault-io/documentation-specialist-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/documentation-specialist-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/documentation-specialist-2/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/documentation-specialist-2 --- # Documentation Specialist Skill (文档专家技能) ## 能力 (Capabilities) - **文档检索**: 快速查找和总结位于 `docs/` 目录下的设计文档、规范文档和计划文档。 - **文档生成**: 根据代码变更自动更新或创建新的 Markdown 文档。 - **规范检查**: 确保文档遵循项目的文档结构和风格指南 (如 `AGENTS.md` 和 `docs/standards/documentation.md` 中定义的)。 - **计划管理**: 能够读取 `docs/plan/todo.md` 和 `docs/plan/roadmap.md` 以了解当前任务状态，读取 `docs/plan/todo-archive.md` 以了解已归档任务状态。 - **门户维护**: 负责更新根目录下的 `README.md`，确保其与项目特性和状态保持同步。 - **流程对齐**: 涉及发布或 Review Gate 说明时，优先对齐 `scripts/release/pre-release-check.mjs` 与 `scripts/review-gate/generate-evidence.mjs` 的实际行为，避免文档与脚本口径漂移。 ## 指令 (Instructions) 1. **Worktree 意识**: 大规模文档更新务必在 `../momei-docs` 目录执行，确保文档版本独立于代码开发分支。 2. **目录感知**: 始终在 `docs/` 目录下操作（除了根目录的 `README.md`）。了解子目录结构： `design/` (设计), `standards/` (规范), `plan/` (计划), `guide/` (指南)。 3. **标准对齐**: 在编写文档前，必须阅读并遵循 [文档规范](../../../docs/standards/documentation.md)。 3. **交叉引用**: 在编写文档时，正确使用相对路径链接到其他文档。 4. **保持同步**: 当代码发生重大变更时，主动建议更新相关的 API 文档、设计文档以及根目录的 `README.md`。 5. **发布与审计同步**: 如果变更影响发布前校验、证据模板或 Review Gate 流程，优先同步 `docs/plan/todo.md`、相关标准文档和脚本行为说明。 6. **格式规范**: 使用标准的 Markdown 格式。对于图表，使用 Mermaid 语法。 6. **读取优先**: 在回答有关“如何做”的问题时，优先查阅 `docs/standards/` 下的规范文档。 7. **站点维护**: 涉及目录结构变更时，应同步考虑更新 `docs/.vitepress/config.ts` 中的导航和侧边栏配置。 ## 使用示例 (Usage Example) 输入: "查阅 API 设计规范关于状态码的定义。" 动作: 读取 `docs/standards/api.md` 并提取状态码部分。 输入: "更新 API 文档以包含新的文章发布接口。" 动作: 读取 `server/api/posts/index.post.ts` 的代码逻辑，然后在 `docs/design/api.md` 中添加对应的接口描述。 --- > Source: [CaoMeiYouRen/momei](https://github.com/CaoMeiYouRen/momei) — distributed by [TomeVault](https://tomevault.io).