doc-sync-check

检查文档与代码的一致性。范围：$ARGUMENTS（空或 all 则全量）。

公共步骤模板见 skills-spec/01_skill_authoring_guide.md §A-§E。本 Skill 不生成代码，故第 5 步测试同步不适用，但仍需读 §A-§C。

第 0 步：🚫 模块特殊规则（§A 之扩展）

当前阶段的 🚫 模块（BUILD_STATUS.md §0）：

• 代码侧：相关代码文件不存在是预期，不报"代码缺失"
• 文档侧：相关 md 完整保留是预期，不报"文档多余"
• 输出时把 🚫 项独立成"已知跳过项"小节

第 1 步：读取范围判定表（公共必读见 §B）

读 CLAUDE.md「范围判定表」——它是"代码路径 ↔ 文档路径"的完整双向映射。

第 2 步：9 维度检查

维度 1：代码存在但文档缺失（最严重）

• 扫描 controllers/http/{audience}/ 下所有 .go → 检查 docs/api/ 对应文档
• 扫描 service/ 下所有 public 方法 → 检查 docs/service/service_design.md
• 扫描 models/ 下所有 struct → 检查 docs/schema/database_design.md，逐字段对比
• 扫描 middleware/ → 检查 docs/architecture/middleware.md
• 扫描 router/command.go 注册的命令 → 检查 docs/service/scheduled_tasks_design.md
• 扫描 helpers/ 导出函数 → 检查 docs/architecture/helpers_api.md

维度 2：文档存在但代码缺失

• 扫描 docs/api/ 中接口 → 检查对应 controller
• 扫描 docs/service/service_design.md 方法 → 检查对应 service
• 扫描 docs/schema/database_design.md 表 → 检查对应 model

维度 3：INDEX.md 完整性

扫描 docs/ 下所有 .md（递归）→ 检查 docs/INDEX.md 是否登记

维度 4：路由一致性

• 读 docs/architecture/routing.md §5 完整路由表
• 读 router/ 下 .go 文件，提取实际注册路由
• 双向对比

维度 5：Redis Key 一致性

• 从 docs/cache/cache_design.md 和 docs/schema/database_design.md §4 提取所有 Key 模式
• 在 service/ 和 controllers/ 中搜索 Redis 操作
• 检查 Key 名称一致性

维度 6：错误码一致性

• 从 components/error.go / service_error.go 提取所有定义
• 与 docs/architecture/status_codes.md 对比

维度 7：测试覆盖

• 扫描 controllers/http/ 下已实现的 handler
• 检查 test/cases/{audience}/ 是否有对应测试文件
• 输出"代码已实现但测试缺失"列表 → 🔴

维度 8：规范主体业务名泄漏（仅当 scope 含 aiweave 或 all 时启用）

此维度审计 aiweave/docs-spec/* 与 aiweave/skills-spec/* 的"规范主体 vs 参考示例"双轨结构是否被违反。详细规则见 PRINCIPLES.md §12 占位符规则。

⚠️ 本维度自身豁免声明（§12.6 #6 meta 内容）：本节下方第 2 步的"业务名关键词清单"、第 5 步的"误报抑制规则"是 audit 规则的 meta 内容——这些清单行不参与自身的维度 8 审计。AI 在扫描 templates/skills/doc-sync-check/SKILL.md 时应主动跳过本节内的关键词清单与对照表（按行匹配"Register / Login"类清单格式即可识别）。