用途:评估项目文档是否足以支撑可靠的 AI 辅助规划与对齐,量化各层证据质量,并给出最小、按优先级排序的补齐计划。
主要能力:按目标、需求、架构、里程碑、路线图、待办六个层做文档盘点与映射;检查新鲜度信号(更新时间、过期引用、明显失效链接);标注证据来源为 canonical、secondary 或 none;每层评为 strong、weak 或 missing,并给出整体就绪度 high、medium、low;对缺口按影响、工作量、负责人、时间窗排序;产出最小补齐计划并持久化报告。
使用方式:输入文档根路径(默认仓库文档根)、可选自定义路径映射、可选目标就绪度(medium 或 high)。默认层路径为 docs/project-overview/、docs/requirements-planning/、docs/architecture/、docs/process-management/,兼容旧别名如 docs/requirements/。报告默认写入 docs/calibration/YYYY-MM-DD-doc-readiness.md,或用户指定路径。报告含层就绪度、缺口优先级列表、最小补齐计划与机器可读摘要。
适用场景:对齐置信度低、新仓库文档不全需确定先补什么、发布前治理核查、文档债务分诊。
限制:不虚构不存在的文档;不重写产品战略、需求或架构决策;最小计划足够时不建议全面重构;关键层缺失时不得评为 high。需求质量、架构清晰度、文档骨架缺失分别交接给 analyze-requirements、brainstorm-design、bootstrap-project-documentation;任务后漂移校准交给 execution-alignment。