用途:自动化生成永久 IPLAN(每个 SPEC/TDD 组件一份)。输入可为 IPLAN id/路径、SPEC 或 TDD id/路径、自由文本提示词或已有 IPLAN 路径,优先级为显式 IPLAN > SPEC/TDD 上游 > 提示词;无显式输入时按提示词处理。它会检测文档是否存在:缺失则生成,存在则审计并按需修复。临时缺陷修复计划需手动编写,不进入索引。
主要能力:分析源文档、规划测试优先的文件清单、生成完整 IPLAN、校验 CODE-Ready、维护 IPLAN-00_index.yaml,并驱动审计与修复循环直至达标。支持单个、批量(每次 3 个)和 dry-run 三种模式。质量门槛为审计分数达到阈值(默认 90,0 个 Tier-1 错误),未达标则重复修复,超过最大迭代(默认 3)则标记人工复核并继续批量。
使用方式:团队模式先调用驱动:
python3 "${CLAUDE_PLUGIN_ROOT}/tools/saga_driver.py"
--layer 08_IPLAN
--allow-skip-permissions
超时至少 1800 秒。驱动返回后读取 .aidoc/review/08_IPLAN/${ARTIFACT_ID}/saga.json,最终状态为 CLOSED、ESCALATED 或 PARTIAL_TIMEOUT;仅 CLOSED 时更新索引。另有 single_pass 线性流程(输入分析、清单规划、生成、校验、审计修复循环)仅供手动 dry-run。
模型预检为建议性:若 .claude/aidoc-flow.config.yaml 缺失或无 model.* 键则跳过;按 model.precheck(warn/silent/block)提示,但无法切换会话模型。
限制与错误处理:源 SPEC/TDD 低于 IPLAN-Ready 阈值时停止并报告上游缺口;迭代耗尽则写报告并标记人工复核;输入歧义时回退提示词模式并在 IPLAN 中记录假设;写入或权限错误时跳过该项继续批量。应用前读取 .aidoc/profile.yaml,遵循 section_toggles、active_layers、audit_threshold(仅可收紧)和 glossary。具体收费、价格与平台信息暂未提供。