用途：doc-sync 用于在 .claude/ 下的 agent 与 command 文件变更后，自动更新 docs/workflow/ 中的工作流文档，避免文档漂移。
主要能力：基于 git diff 检测变更（git 不可用时回退到时间戳检测）；解析并校验 YAML frontmatter（必填 created、updated、version，可选 type、triggers、name、description、model、tools、spawns、kb_tools、mcp_tools）；按命名模式将 agent 映射到文档章节并更新表格；根据 spawns 字段重新生成 Mermaid 图；按变更类型（major/minor/patch）起草 changelog 条目并递增版本；生成 SYNC-REPORT.md 同步报告；可集成 pre-commit 钩子做校验。若 postgres-knowledgebase MCP 工具可用，还会查询数据库元数据并与文件 frontmatter 合并（数据库优先），超时或不可用时回退为仅文件模式。
使用方式：/doc-sync 执行完整同步；/doc-sync --check-only 为只检查模式，不同步文件，同步返回 0、不同步返回 1，适合 pre-commit 钩子；/doc-sync --force 忽略 git 状态处理全部文件。两个标志同时使用时 check-only 优先。
适用场景：修改或新增 agent/command 文件后同步文档；提交前校验文档是否同步；大规模重构后强制重建文档。
限制：无法匹配已知命名模式的 agent 会进入人工复核区；YAML 无效的文件会被跳过；Mermaid 校验失败时保留原图并记录警告；数据库相关能力依赖 postgres-knowledgebase MCP 工具是否可用。具体收费、价格与平台信息暂未提供。