用途:doc-sys-autopilot 位于文档体系第 6 层(系统需求),用于把上游的 ADR 架构决策自动转换为 SYS 系统需求文档,产出功能需求、质量属性、接口规格、数据管理、测试验证、部署运维、合规、验收标准、风险与追溯等章节,并计算 REQ-Ready 评分,供下游第 7 层 REQ 使用。
输入方式:支持 --ref <path>、--prompt "<text>"、--iplan <path|IPLAN-NNN> 三种模式,优先级为 --iplan > --ref > --prompt。IPLAN 解析顺序为:显式文件路径存在时直接使用,其次解析 work_plans/IPLAN-NNN*.md,再解析 governance/plans/IPLAN-NNN*.md;多个匹配时报错并要求消歧。主来源与补充来源在目标/范围上冲突时属于阻塞冲突,需用户澄清。
主要能力:根据输入类型智能判定动作。输入 SYS-NN 时进入评审模式;输入 ADR-NN 时,若对应 SYS-NN 已存在则转为评审,否则从 ADR 生成 SYS。文件存在性检查使用嵌套目录,例如 ls docs/06_SYS/SYS-{NN}_*/。
工作流分五阶段:阶段 1 分析 ADR(架构决策、系统约束、技术需求目录);阶段 2 检查 SYS-Ready 评分,权重为决策完整性 30%、架构清晰度 35%、实现就绪度 20%、验证方法 15%,最低 90 分,未达标会标记缺失要素并告警或中止;阶段 3 按 SYS 模板生成文档,包含文档控制、功能需求、质量属性、接口规格等,并使用 quality-advisor 实时质检,检测反模式、元素 ID 格式(SYS.NN.xxxx)、占位符与 @threshold 标签;阶段 4 运行 doc-sys-validator 校验结构与 REQ-Ready 评分(阈值 90%),不达标则用 doc-sys-fixer 自动修复并复验;阶段 5 运行 doc-sys-reviewer 评审打分(阈值 90),低于阈值进入修复迭代,达到最大迭代次数则标记人工复核,最后核对跨 SYS 一致性并更新追溯矩阵。
输出文件始终使用嵌套目录:docs/06_SYS/SYS-NN_{slug}/SYS-NN_{slug}.md;超过约 20k tokens 时按章节拆分;复杂系统可按能力模块拆分(如 SYS-01.01_authentication.md),并维护 SYS-00_index.md。生成的文档 frontmatter 中 document_type 必须为 sys-document(非 template),artifact_type 为 SYS,layer 为 6。
适用场景:ADR 已完成且 SYS-Ready 评分不低于 90% 时批量生成系统需求、保证项目内 SYS 质量一致、在 CI/CD 中自动化 SYS 生成与校验。限制:不适合手工深度定制单个 SYS(应直接用 doc-sys)、ADR 不完整或评分低于 90 的场景、仅编辑指定章节,或仅需校验已有 SYS(应使用 doc-sys-validator)。具体命令参数细节、依赖技能的完整说明以原始技能文档为准,部分内容暂未提供。