SuperAPI AI 工具集

apex-tier1

编程与开发

查看项目

更新于 10-16 07:45

技能介绍

APEX Tier 1 — Fire and Forget 是 APEX 技能体系中的第一层级,定位为“发射后不管”的自主执行模式:从任务开始到结束全程无需人工介入,完成后自动打开一个草稿 PR。

用途

Tier 1 用于执行定义明确、可直接落地的工作,例如添加测试、修复 lint 错误等。当以下条件全部满足时,才应使用 Tier 1:

  • 任务具有清晰、无歧义的验收标准;
  • 失败成本低(容易回滚);
  • 不需要架构决策;
  • 范围较小(一个功能、一个修复、一组文件)。

当任务需要设计决策时,应改用 apex-tier2 或 apex-tier3;当任务涉及关键基础设施时,应使用 apex-tier3;当需求模糊时,应先澄清,再决定层级。

主要能力

Tier 1 的核心能力是自主完成一个明确定义的任务并产出草稿 PR。其工作流程包含五个步骤:

  1. 将任务解析为验收标准:把任务描述转换为清单。例如任务“为 UserService 类添加单元测试”可解析为:测试覆盖 UserService 的所有公共方法、测试覆盖类中记录的错误/边界情况、所有测试通过、覆盖率不下降、lint 通过。如果无法创建至少 2 条具体的验收标准,说明任务对 Tier 1 而言过于模糊,应要求用户澄清或升级到 Tier 2。
  2. 创建工作分支:使用命令 git checkout -b apex/{task-slug} && git push -u origin apex/{task-slug}。
  3. 实现改动:编写代码,遵循 AGENTS.md 中的项目约定,不重构无关代码,不改变范围之外的格式。
  4. 自校正循环:运行验证并迭代直到通过。Linux/Mac 使用 bash "${CLAUDE_SKILL_DIR}/scripts/validate.sh" <target-dir>,Windows 使用 powershell -File "${CLAUDE_SKILL_DIR}/scripts/validate.ps1" <target-dir>。最多进行 5 次修复循环;若 5 次后仍失败,则提交现有内容,在 PR 描述中记录失败情况,并标记为需要人工审查。
  5. 打开草稿 PR:使用命令 gh pr create --draft --title "apex: {task description}" --body-file /tmp/apex-pr-body.md。PR 正文必须包含:任务描述、验收标准清单(已勾选/未勾选)、验证结果(lint、类型、测试、构建)、以及任何标记为 [NEEDS REVIEW] 的未解决问题。

使用方式

Tier 1 通过上述五步工作流使用。最终输出是一个位于功能分支上的草稿 PR,其中所有验收标准均已满足且验证通过。示例 PR 正文包含任务说明、验收标准勾选列表、验证结果表格(Lint、Types、Tests、Build 均显示 PASS)以及变更文件列表。

适用场景

适用于验收标准明确、失败成本低、无需架构决策且范围较小的任务,例如为某个类添加单元测试、修复 lint 错误等。

限制

不适用于需要设计决策的任务(应使用 apex-tier2 或 apex-tier3)、涉及关键基础设施的任务(应使用 apex-tier3)以及需求模糊的任务(应先澄清再决定层级)。自校正循环最多 5 次,超出后需人工审查。