SuperAPI AI 工具集

ns-implement-1-0-0

编程与开发

查看项目

更新于 11-14 09:59

技能介绍

用途

ns-implement-1-0-0 是一个编码代理技能,用于按照用户提供的规格说明或工单实现一项工作。技能的核心是把「实现」流程标准化:先准备分支、再写代码、再审查、再提交,并产出一份可执行的审查记录。

主要能力

  • 分支准备与记录:要求先从基础分支(即工作合并进去的分支)创建新分支。基础分支和命名模式记录在 docs/agents/branching.md 中,模式如 <type>/<slug> 或 feature/<ticket>-<slug>。文件缺失时运行 git branch -r 查看集成候选和已有命名,然后询问用户确认基础分支和模式,并把二者写入该文件,供后续运行读取。
  • 启动检查:使用 git fetch origin、git switch <base> && git pull、git switch -c <命名模式填充> 创建分支;只有 git status 显示干净工作树且 git merge-base --is-ancestor origin/<base> HEAD 退出码为 0 后才开始写代码。
  • 实现与测试:在可能的情况下,在预先约定的接缝处使用 /tdd;定期运行类型检查和单个测试文件。
  • 代码审查:提交工作到当前分支后,以 origin/<base> 为固定点运行 /code-review。把审查发现分为机械性发现(有明确修复)和判断性发现(权衡或风格选择,保留并给出一行理由)。运行完整测试套件一次。
  • 提交记录:修改提交,使其携带修复,并在提交信息正文最后一部分附上代码审查记录。记录格式为每行一个发现,引用 file:line,每行 72 列换行,标题为纯文本 Code review 行(因为提交清理可能剥离以 # 开头的行)。每个轴以总计行结束;若跳过规格轴,其列表和总计行均写 no spec available。
  • 收尾消息:以一条自包含消息结束运行,按紧急程度分六部分:Look at this first、Before this PR merges、To run it now、手动测试、Least confident、代码审查记录。
    • Look at this first:列出每一处高风险变更(失败代价高于一次后续提交,如数据丢失、不可逆数据变更、迁移、认证/权限、金钱、公共 API 或存储格式、无撤销的破坏性用户操作),用 ### 🔴 标题和 Where、If it's wrong、Look at 三个要点描述;无高风险时写 High risk: none。
    • Before this PR merges:列出只有用户能做的合并前操作,每项一个编号复选框,写明位置和确切值或命令;无操作时写 Before merge: none。
    • To run it now:列出手动测试前用户必须在本机执行的操作,每项一个编号行,写明确切值或命令;无操作时写 To run it now: nothing。
    • 手动测试:每个用户可见变更一个流程,以 ### Flow N: <变更> 标题;每个流程以 Setup 列表开始,步骤从 1 编号,每行一个动作 → 可观察结果;涉及高风险变更的步骤以 🔴 和变更编号结尾。
    • Least confident:列出最不信任的部分,每项以 🟡 Medium 或 🟢 Low 开头加粗体陈述,附 Why unsure、Check、Where 三个要点;按错误影响排序,至少一项。

使用方式

技能由代理在实现任务时调用,按照上述流程执行。用户需要提供规格说明或工单。代理会按步骤操作,并在最后输出六部分收尾消息。

适用场景

适用于有明确规格或工单的代码实现任务,尤其是需要分支管理、测试驱动开发、代码审查和可审计提交记录的开发流程。

限制

本技能依赖 docs/agents/branching.md 的存在或用户确认分支信息;需要 /tdd 和 /code-review 等配套技能可用;手动测试和收尾消息需要用户参与。具体功能、收费、价格、平台、效果等信息暂未提供。