SuperAPI AI 工具集

author

编程与开发

查看项目

更新于 11-14 08:09

技能介绍

用途 该技能在项目起始阶段运行一次,产出后续所有阶段规格与代码的唯一权威来源——主规格说明,并把规格拆解为按依赖排序、可独立执行的阶段计划,交给同系列技能 /spec-pipeline:execute-phase 逐阶段实现。

主要能力

  • 需求接收:从参数路径、当前对话或笔记中读取项目简报,确定问题陈述、目标与非目标、目标环境与依赖边界、语言/工具链、硬性约束(默认 Python 工具链为 uv、ruff、BasedPyright strict、pytest + coverage.py,按需使用 FastAPI / Pydantic v2 / Typer)。
  • 架构与范围草案:定义系统边界、主要组件、关键技术决策与数据/接口形态,并给出初步阶段划分。
  • 主规格编写:基于模板 master-spec.md 撰写结构化规格,覆盖概览、架构、数据模型、接口、行为规则、错误处理、测试策略、验收标准、范围外事项等章节。
  • 阶段拆解:倾向可测试的纵向切片;第一阶段建立项目骨架、工具链配置与 CI,确保后续阶段具备 RED→GREEN 测试环境;阶段按依赖排序且依赖图无环,每阶段规模受评审成本约束。
  • 评审门:先运行 specpipe 结构校验,出错须修复重跑;再做一次 ultracode 工作流评审,检查需求覆盖(每条需求恰好归入一个阶段)、依赖正确性、阶段独立可执行性、第一阶段是否建立测试框架;随后用 /codex-review 迭代至收敛(最多 3 轮)。
  • 初始交接状态:通过 specpipe init-project 创建最小目录(默认 docs/handoff/phase-plan.md、docs/handoff/audit/、.spec-pipeline/),写入带状态字段的阶段计划。
  • 收尾:提交并推送主规格、阶段计划与交接脚手架。

使用方式 技能依赖 /codex-review(Codex CLI)与 ultracode 工作流支持,缺少任一项即中止。参数 $ARGUMENTS 传入项目简报路径。执行流程为:接收 → 架构与范围草案(唯一人工确认点,可事先约定跳过以全程无人值守)→ 主规格编写 → 阶段拆解 → 评审(校验 + 工作流 + Codex 收敛)→ 初始化交接状态 → 提交推送。specpipe 调用形式为:PYTHONPATH="${CLAUDE_PLUGIN_ROOT}/scripts/specpipe" uv run --no-project python -B -m specpipe <subcommand> …;该工具与目录布局无关,各子命令接受显式路径。

适用场景 适用于新项目启动时的规格与阶段规划,尤其是需要多会话、分阶段执行并跨会话传递上下文的工作流。

限制 项目简报过薄、无法推导出可靠范围与架构时须中止并询问;依赖项缺失须中止;架构决策不可逆且无合理默认值时须中止;Codex 评审 3 轮后仍有未解决的错误须中止;推送因认证或远端问题失败须人工介入。阶段 id 一经开始执行不得重新编号。该技能不调用 Superpowers 的 brainstorming 或 writing-plans。

暂未提供 未提供收费、价格、支持的模型平台或具体性能指标等信息。