用途:作为 aidoc-flow 第 3 层(03_EARS)的自动化流水线,从上游 PRD(及其 BRD)、用户提示词或实施计划(IPLAN-*)生成完整的 EARS 文档,并维护 EARS-00_index.md,驱动审计与修复循环直到通过评分;可处理单个 EARS 或批量。
主要能力:智能识别目标 EARS 是否已存在——不存在则进入生成模式,已存在则进入审查与修复模式;依据来源内容确定 deliverable_type(code/document/ux/risk/process,继承自上游 PRD);生成包含文档控制与全部 5 个章节、原子语句、表格化质量属性(百分位计时)、元素 ID(EARS.NN.SS.xxxx)、累积 @brd/@prd 标签、@threshold: 引用与状态/序列图标签的 EARS;完成后执行质量门禁(BDD-Ready ≥ 阈值、0 个 Tier-1 错误),只有通过才更新索引。
使用方式:团队模式下第一步须用 Bash 工具运行驱动,命令为 python3 "${CLAUDE_PLUGIN_ROOT}/tools/saga_driver.py" --layer 03_EARS --allow-skip-permissions(去掉该标志则保留正常权限提示),并设置充足超时(≥1800s),不要预先分析输入。驱动返回后读取 .aidoc/review/03_EARS/${ARTIFACT_ID}/saga.json,状态应为 CLOSED、ESCALATED 或 PARTIAL_TIMEOUT,并报告最终分数与一行摘要;仅在 CLOSED 时更新索引行及上游产物的下游条目。single_pass 线性模式为旧行为,含输入分析、就绪检查、生成、验证、审计↔修复五步,不产生 saga.json,仅适合手动试运行。
可配置:输入可接受目标 EARS id/路径、上游 PRD id/路径、自由文本提示词或 IPLAN 路径;可选评分阈值(默认 90)、最大修复次数(默认 3)、批量清单。支持 Single、Batch(每批 3 个以控制上下文)、Dry-run(只报告计划动作不写文件)三种执行模式,并读取 .aidoc/profile.yaml 适配配置(section_toggles、active_layers、audit_threshold 仅可调严、glossary)。
限制与错误处理:上游 PRD 缺失或未达 EARS-Ready 阈值时停止并报告;达到最大迭代仍未通过则写报告并标记人工审查后继续批量;输入不明确时回退到提示词模式并记录假设;语句含糊或复合无法自动解决时标记人工审查;写入/权限错误则记录、跳过并继续。模型预检为建议性,无法切换会话模型,仅在 .claude/aidoc-flow.config.yaml 存在且含 model.* 键时生效,行为由 model.precheck(warn/silent/block)决定。具体收费、平台支持等信息暂未提供。