SuperAPI AI 工具集

tracer-implement

编程与开发

查看项目

更新于 10-16 02:23

技能介绍

用途

tracer-implement 用于实现一个工单或请求,交付约定的行为,并采用尽可能小的、针对具体仓库的改动。其整体流程为:简短计划与批准 → 实现 → 一次审查 → 必要时修复 → 验证并报告。该技能在功能分支上停止,不合并、不打开 PR、不调用其他审查工作流。若需要完成分支收尾选择,应使用 /tracer-autopilot。

主要能力

  • 工作区与证据计划:检查分支和工作树,保持在已有功能分支上;在 main 或 master 上时遵循 /tracer-worktrees;对 detached HEAD 或归属不明确的情况进行询问。保留无关改动。确保 .tracer/ 在写入工作流产物前已被忽略。新运行时在 .tracer/implement/progress.md 记录起始 SHA;恢复时读取该账本并对照 Git 验证范围、基线、提交、运行中的 worker 和已保存报告。
  • 选择最小检查集:默认使用聚焦测试。仅当仓库策略要求、用户要求或影响足够大时才运行完整套件或广泛类型检查,并解释该选择。否则报告广泛验证留给 CI 或用户。没有现有测试的新功能需要失败验收测试,而非全仓库基线。
  • 简短计划与批准:编写 .tracer/implement/plan.md,通常每个连贯行为几条要点,包含目标、来源、验收与限制、方法、验证。按连贯行为分组任务,而非框架层次。展示目标、方法、任务顺序、委托(如有)和检查,等待批准并记录。
  • 实现:在同一上下文中按计划推进。对新行为或修正行为使用聚焦的红/绿测试,适当使用现有检查;仅文档变更需要相关验证,而非虚构运行时测试。优先使用现有设施而非新抽象。若方法开始需要远超批准范围的机制,停止并提出更小的替代方案。使用仓库约定提交连贯改动。
  • 审查与可选修复:固定当前 HEAD,对完整约定范围运行一次 scripts/review-package BASE HEAD。使用 ticket-reviewer-prompt.md 进行一次审查,最好由一名独立的只读审查者完成;若无法委托或委托不划算,则内联审查。仅接受具有可达触发条件、违反需求且当前有后果的发现。将审查和处置保存到 .tracer/implement/review-1.md。
  • 最终证据与报告:针对最终 HEAD 和已跟踪树状态验证约定检查。复用同一未变状态的已完成证据;变更后重跑受影响检查。记录命令、实际结果和不可用检查。报告目标、提交、审查结果、修正、推迟的关切、验证限制和保留的分支。

使用方式

该技能以工作流形式运行,涉及以下关键文件与脚本:

  • .tracer/implement/progress.md:账本,记录范围、不可变基线、已批准计划、实现提交/上下文、审查与修复状态、已检查的 HEAD/树、证据、关切和结果。
  • .tracer/implement/plan.md:任务计划,包含目标、来源、验收与限制、方法、验证,以及按连贯行为分组的任务。
  • scripts/task-brief:用于提取相关任务。
  • implementer-prompt.md:委托实现时使用。
  • scripts/review-package BASE HEAD:生成审查包。
  • ticket-reviewer-prompt.md:审查提示。
  • fixer-prompt.md:修复提示。
  • .tracer/implement/review-1.md、repair-report.md、review-2.md:审查、修复报告和复查记录。

预算覆盖整个约定范围,包括委托和内联工作:一次初始审查、至多一次修复、若进行了修复则一次仅针对修正的复查。助手不能启动审查或修复者。复查后报告未解决工作并停止;只有用户明确新授权才能延长预算。

适用场景

适用于需要受控、可追溯地实现单个工单或请求的开发场景,尤其是希望以最小改动交付、避免过度设计、并保持清晰审查与验证记录的工作流。也适用于需要恢复中断实现、或需要将实现委托给独立单元但仍保持验收要求与限制的场景。

限制

  • 在功能分支上停止,不合并、不打开 PR、不调用其他审查工作流。
  • 默认使用聚焦测试,广泛验证留给 CI 或用户,除非有明确理由。
  • 审查预算有限:一次初始审查、至多一次修复、一次仅针对修正的复查。
  • 助手不能启动审查或修复者。
  • 对自定义基础设施(如自定义解析、通用进程运行器、权限评估器、并发保证或持久化恢复机制)需先解释具体需求与更简单替代方案并询问。
  • 安全重跑本身不意味着并发执行或自动崩溃恢复。
  • 保留所需的数据/安全防护;暴露权衡而非悄悄削弱。
  • 缺失事实:官方文本未提供,具体价格、平台支持、安装命令等暂未提供。