SuperAPI AI 工具集

detail

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:这是 Arc 内部的计划编写流程,用于把上游输入转成可执行的实现计划。输入可为 implement 的功能规格(优先 docs/arc/specs/*-spec.md)、improve 的已审查发现(含证据、影响、修复草案与范围外候选项),或 implement 转发的直接范围请求;范围缺失时通过提问补齐,无用户时从请求约束与仓库证据推断,未答问题记入决策日志并标记计划未确认。

主要能力:检测包管理器、框架、测试与仓库校验命令,记录 Planned at 短 SHA;映射待建/改动文件、既有接口与可观察 seams、相关测试、可复用模式与需独立计划的子系统;选择 Lean/Standard/Guarded 保证级别(取最高适用风险,Guarded 不可降级),并在任务前建立计划级 seams 注册表,按引用规范的任务类型书写 XML 切片与证据。

使用方式:禁用 EnterPlanMode/ExitPlanMode;需完整 Arc bundle,agents/、references/、scripts/ 等路径从插件根解析,其余为用户仓库。规划前须阅读 references/ 下 implementation-assurance、task-granularity、testing-patterns、checkpoint-patterns、arc-paths、plan-lifecycle。可按需运行 python3 scripts/codebase-map.py . --format markdown。计划头部字段固定,随后写文件结构、seams、依赖排序 XML 切片、全 pending 的 Implementation state 块、空 Decision log,并在 docs/arc/plans/INDEX.md 写入状态 TODO 的行。最后派发 agents/workflow/plan-document-reviewer.md 校验,反复修正最多五次后升级用户;无人值守时记录未解决问题并返回未批准。

限制:仅用于 Arc 计划编写流程;不输出测试源码或 <test_code>;不引入仅为测试便利的公共 API;检查点仅用于真正的主观人工判断或未决方向,不设固定批量暂停;不得静默提交,须由用户批准或批准并提交。