用途:对 .aisdlc/project/ 的 Discover(逆向)成果做 DoD 自检与门禁收口,让成果可维护、可追溯、可导航,避免在压力下退化为细节堆积。
使用方式:开始时宣布「我正在使用 aisdlc-project-discover-dod-gates 技能对 Discover 成果执行 DoD 自检与门禁收口。」
项目级 DoD 最小自检清单:memory/ 四份已具备入口清晰、边界清晰、可导航;Level-1 索引骨架已生成且复选框进度可用;每个 P0 模块满足 components/{module}.md 存在且边界清晰(In/Out),contracts/api/{module}.md 与 contracts/data/{module}.md 均具备三件套(权威入口 + 不变量 + 证据入口);索引回填完成(components/index.md、contracts/*/index.md);products 已收敛到 ≤ 6,若无法收敛需记录原因与治理入口;索引只导航、细节不双写,模块页/契约页为权威入口;若有 ops,ops/index.md 提供可定位入口(dashboard/告警/runbook/回滚),且不复制操作手册。
门禁规则:索引只导航,任何 index.md 出现字段表格、详细时序或操作手册即视为失败;契约页不写字段大全,只保留权威入口与不变量摘要;证据缺失不允许脑补,只能写“未发现 + 下一步如何找”,并把缺口暴露给维护者。
常见陷阱与规避:试图一次性写全,应先 Scope、P0 先落地、P1/P2 只占位;把一次性交付细节写进项目级,应只写入口、边界与护栏;索引与模块双写,应让索引只导航、模块页/契约页为权威;契约不权威,必须三件套缺一不可。
红旗清单(出现任一条即停止并回滚):新增 .aisdlc/project/docs/(data-dictionary/api-reference)承载字段大全;新增 .aisdlc/project/flows/ 或 .aisdlc/project/ops/runbooks/* 承载一次性交付细节;采用“先把细节写全,索引以后补”的交付方式;P0 模块缺契约页或缺证据入口却宣称已完成。