SuperAPI AI 工具集

doc-spec-autopilot

通用与其它

查看项目

更新于 10-16 02:29

技能介绍

用途:自动化 SPEC 生成流水线。它从上游 BDD/ADR 文档、用户提示词或实现计划(IPLAN-*)分析来源,生成完整组件 SPEC,校验就绪状态,维护 SPEC-00_index.md,并驱动审计↔修复循环直至通过分数,支持单个或批量。

主要能力:智能文档检测——若目标 SPEC 不存在则进入生成模式,已存在则进入审查与修复模式;SPEC-NN 输入按自身类型处理,BDD-NN/ADR-NN 作为上游来源。模型预检为建议性,读取 .claude/aidoc-flow.config.yaml 的 model.* 配置,按 warn/silent/block 行为提示推荐模型,但无法切换会话模型。

使用方式:团队模式下第一步必须调用 Bash 工具运行驱动:python3 "${CLAUDE_PLUGIN_ROOT}/tools/saga_driver.py" --layer 06_SPEC --allow-skip-permissions,建议超时≥1800s,不要预先分析输入。驱动返回后读取 .aidoc/review/06_SPEC/${ARTIFACT_ID}/saga.json,状态为 CLOSED、ESCALATED 或 PARTIAL_TIMEOUT,并打印最终分数。仅在 CLOSED 时更新索引。single_pass 模式为旧版线性流程,仅适合手动试运行。

适用场景:需要从上游文档或计划批量生成、审查并修复 SPEC 的工程流程。

限制:生成须通过审计(TDD-Ready 分数≥阈值、0 个 Tier-1 错误)或达到迭代上限后转人工审查;上游 ADR/BDD 缺失则停止;输入不明确回退提示词模式;写入错误则跳过并继续批量。默认阈值 90、最大修复迭代 3。具体收费、价格与平台信息暂未提供。