From ai-sdd
AI-SDD 健康检查。只读检测 .ai/doc/ 与代码的一致性,不修改任何文件。 触发词:检查文档漂移、文档与代码一致吗、AI-SDD 健康检查、文档诊断、check docs
How this skill is triggered — by the user, by Claude, or both
Slash command
/ai-sdd:ai-sdd-checkThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
只读操作,不修改任何文件。检测 `.ai/doc/` 中的规范文档与实际代码之间的一致性。
只读操作,不修改任何文件。检测 .ai/doc/ 中的规范文档与实际代码之间的一致性。
.ai/ 是否存在 → 如不存在,提示先运行 /ai-sdd-init.ai/doc/ 是否存在 → 如不存在,提示先运行 /ai-sdd-reverse 或手动创建.ai/doc/ 下是否有 doc 文件 → 如为空,提示无文档可检查扫描 .ai/doc/ 下的所有文件,记录:
00-架构.md)01-需求.md)03-详细设计/*.md)根据 doc 文件中描述的模块和功能,读取对应的源代码。
按四个维度检测:
维度 1:架构漂移
00-架构.md 中的模块列表 vs 代码中的实际模块目录维度 2:需求漂移
01-需求.md 中的功能列表 vs 代码中的 API 路由/UI 组件维度 3:设计漂移
03-详细设计/<模块名>.md 中的 API 契约 vs 代码中的实际实现维度 4:结构漂移
=== AI-SDD 健康检查报告 ===
[文件路径]
[状态] [描述](失效类型:[类型])
状态说明:
✅ 一致 — 文档与代码匹配
⚠️ 轻微漂移 — 小的过时(如缺少新增参数)
❌ 严重漂移 — 文档与代码根本对不上
📭 缺失 — 代码中有模块但没有对应 doc
🗂️ 结构问题 — 追加式更新、内容混乱、角色不符
失效类型(对应 S06 失效模式):
文档腐烂 — 内容与事实不符
文档质量退化 — 内容正确但组织混乱
规范过度设计 — 文档比实现还重
上下文泄漏 — 实现偏离了最终设计
覆盖范围说明:
本 skill 覆盖 S06 七种失效模式中可自动检测的 4 种(上表)。
另外 3 种属于人类行为模式,需要开发者自评:
- 模式僵化 → 每季度反思"流程本身是否需要调整"
- AI 盲从过时文档 → 通过"需求漂移"维度间接发现
- 人类橡皮图章化 → 每 5-10 个任务做一次深度审查
总结:X 个一致,Y 个轻微漂移,Z 个严重漂移,W 个缺失,V 个结构问题
[如有漂移] 建议:运行 /ai-sdd-rebuild 修复严重漂移和结构问题
用户可通过触发词选择审计深度:
| 模式 | 触发词(举例) | 检查范围 |
|---|---|---|
| 快速检查 | "快速检查文档" | 仅检查架构漂移(维度 1),5 分钟 |
| 标准检查(默认) | "检查文档漂移" | 四维度全查 |
| 深度审计 | "深度审计文档" | 四维度 + 结构漂移逐文件详细分析 + 生成修复建议清单 |
.ai/project-log.md 的「待同步文档」区段/ai-sdd-rebuildnpx claudepluginhub zongzi78/agent-plugins-market --plugin ai-sddProvides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.