mcpField
K
kickoff

kickoff

github.com/timmyy3000Agent 工作流238 次安装3 周前更新
代码仓库

关于 kickoff

kickoff 是面向 Agent 的工程工作流技能,指导任务从意图推进到验证和交付。它按风险安排流程,并跟踪授权、审查、任务状态与最终结果。

主要功能

  1. 01按风险选择调查或变更路线
  2. 02选择操作手册并设置流程关卡
  3. 03跟踪任务状态与修正
  4. 04管理审查、实施和交付阶段
  5. 05核验终态并完成收尾

适用场景

  1. 01按歧义和风险规划变更流程
  2. 02跟踪多阶段任务中的决策
  3. 03引导获授权的工作通过审查
  4. 04核验交付并记录收尾情况

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/timmyy3000/skills --skill kickoff

安装后在 Claude Code 中输入/kickoff确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
playbooks/
authoring-a-skill.md
autonomous-run.md
autopilot-full.md
autopilot-stack.md
babysit.md
bug-fix.md
eval.md
feature.md
hillclimb.md
investigation.md
multi-phase-plan.md
opening-a-pr.md
orchestrate.md
pause-safely.md
perf-issue.md
prototype.md
refactoring.md
runtime-forensics.md
session-pickup.md
shipping.md
trace-forensics.md
visual-parity.md
worktree-cleanup.md
references/
bugbot-triage.md
config.md
delegate-brief.md
episode-state.md
harness.md

详细介绍

Kickoff

从意图到验证通过的终态,运行一次工程任务,尽可能减少人工参与,同时确保安全。两层共同构成一个系统:

  • 任务层(路由、任务状态、修正、交付状态、收尾)决定工作采用多少流程,以及何时算真正完成。
  • 工程层(不可妥协项、原则、自主性、子 Agent、回复、操作手册)决定如何开展工作。

按名称调用技能(/kickoff)。不提供模式切换。在其他运行环境中,首次调用前,通过 references/harness.md 映射下方列出的 T3 Code 工具名称。如果运行环境的技能工具未提供某项技能,则从其同级文件夹(<skills-root>/<name>/SKILL.md)读取。

范围与授权

相较于工作流默认设置,应遵循用户明确指定的范围和适用的既有授权。根据既定惯例,继续已获授权的准备工作和可逆操作。保留工程防护措施和访问控制。如果某项技能阻碍了进度,应指出具体指令和实际冲突;如果写入操作在授权范围内,则在该技能自己的 PR 中修复,并继续开展独立且已获授权的工作。

对于只读或无需更改的请求,在对话中返回发现,不得创建或更新计划、状态、记忆、配置或知识记录,除非这些写入操作已获明确授权。

接收任务

做出三项决定,并在任务状态中记录一次。

  1. 路由决定关卡。

    • investigation。只读调查结果。不进入计划、实施或 PR 阶段。
    • tiny。范围狭窄、遵循成熟模式、验收标准明确且风险较低的变更。计划直接写在任务中。仅在触发风险条件时评审计划。
    • fast。范围明确的变更。编写简短的 Markdown 计划并进行对抗性评审。如果计划引入了额外机制,则进行简化评审。
    • full。存在歧义、涉及多个方面、后果严重、难以撤销、前所未有或需要大量协调的变更。编写完整计划,组织跨模型对抗评审,并进行简化评审。

    根据任务所属领域的六个维度进行判断:歧义、影响范围、出错后果、可逆性、新颖性和协调需求。只有在证据显示存在实质性风险时才升级。视觉上很小的关键流程变更也可能属于 full。独立的后端变更则可能属于 tiny。

  2. 操作手册决定步骤。根据下方的「操作手册」部分进行匹配。路由不会删减操作手册中的步骤。即使是 tiny 级别的 bug 修复,也必须先复现问题。

  3. 授权级别决定人工介入的界限。如果用户希望评审计划或差异,则为 supervised。否则为 autonomous,这是默认值。如果用户要求合并、提交、发布、自动执行,或要求“明早之前帮我合并”,则为 land。记录授予授权的确切原话。

只询问实验无法确定答案的问题(不可妥协项)。其余事项都作为已记录的默认设置,用户可提出更正。

任务状态

在获准写入产物时,规划前根据 references/episode-state.md 创建 <task-workspace>/episode-state.md。在阶段转换和交接时更新该文件。它是所有工作者的事实来源,也是压缩上下文或中断后的恢复依据。再次探索代码库前先读取该文件。将其路径传给每位委派者。严格只读的工作只在对话中维护状态。

将用户更正记录为持久化决策。绝不让用户重复已敲定的决定。

Episode 流程

  1. 工作区。 发现仓库说明和产物约定。对于修改任务,在首次编辑前绑定隔离的工作树(harness 映射:Worktrees)。记录路径和初始 Git 状态。
  2. 了解情况。 执行 playbook 的开篇步骤(how、复现、追踪、基线)。其输出是计划的证据索引。
  3. 使用 plan-it 制定计划以确定路径。若 playbook 要求,architect 的输出将成为计划的设计部分。拒绝不成比例或基于未引用假设的计划。
  4. 审查计划,按该路径使用 adversarial-review 和 simplicity-review。为每条发现分配稳定 ID,并记录处理意见。接受的修改需交回 plan-it 处理。
  5. 批准。 在 supervised 模式下,等待用户。在 autonomous 或 land 模式下,评审问题解决后即可继续执行计划,除非计划中有无法通过实验确定的待负责人决策。报告该决策及其默认选项,并继续处理不受其阻碍的工作。
  6. 使用 ship-it 执行。 playbook 的构建步骤在其中运行。ship-it 负责委派、验证、实现评审模式和 create-pr。
  7. 交付。 单 PR 流程通过 create-pr 启用 watch_pull_request,并以 drive 模式运行 Babysit,直至达到可合并状态。堆栈在创建后启用监视(打开 PR)。在 land 模式下,继续执行 Shipping playbook;否则,在 ready-to-merge 状态停止。
  8. 按 Closeout 合约完成收尾;如果本次流程揭示了适合纳入技能的经验,则运行 reflect。

对于 investigation,在第 2 步后停止。报告发现及其来源、不确定性和下一项决策。记录 investigation-complete。

更正与偏移

当用户更正范围、架构、分支目标、监控或收尾要求时:确认具体更正内容,更新任务简报、计划和流程状态,识别因此失效的阶段,仅重新运行这些阶段,并按类别统计更正次数。除非新输入明确取代当前任务,否则将其视为对当前流程的更正。终态之后改变目标的工作属于新流程。

交付状态

  • ready-to-merge。根据代码托管平台的判断,当前提交可合并;必需的检查和评审均已通过,且没有待处理的可执行发现。仅在未获 land 授权时为终态。
  • merged。已验证合并和最终 SHA。记录工作树处置情况和收尾证据后即为终态。
  • delivered-direct。经明确授权的不经 PR 交付,且已验证远程目标 SHA。
  • investigation-complete、canceled 或 blocked-external(注明下一位执行者和操作)。

检查仍待完成的开放 PR 不属于终态。待办事项或一次性状态检查不等于持续监视。

收尾合约

最终回复前,验证并记录终态、最终本地和远程 SHA、检查和评审及未解决的发现、适用时的部署或晋级、分支和工作树处置情况、持久化产物路径、临时文件移除情况、仓库要求的知识记录协调情况,以及监视已停止或有意保留及其原因。ship-it 负责详细的工作树收尾工作。不得声称已完成尚未发生的部署、合并或清理。

版本与依赖预检

每个流程只检查一次已安装的 bundle 版本。如果存在更新的兼容 bundle,仅提示一次更新;若用户接受更新,则必须重新提交任务。用户拒绝后不要再次提示。仅解析该路径和交付流程将运行的阶段所需技能:规划阶段使用 plan-it;适用评审门槛时使用计划评审技能;实现阶段使用 ship-it 和 code-review,另以 ponytail-review 执行独立评审模式;PR 交付使用 create-pr。缺少阶段技能时,按其各自的回退机制处理,绝不静默跳过。

不可妥协的事项

下面的原则部分是每项触发条件的依据。回复中请列出影响决策的每项原则,以及它具体改变了哪项选择。仅引用本次会话中你阅读过其叶级 SKILL.md 的原则。

剩余触发条件:

  • 非简单的更改、架构决策或“确定要这样吗?”→ how 技能。
  • 即将询问用户“选哪种方案”“我该怎么做”或“这应该实现什么功能”之类的分岔问题 → 先对问题分类再询问。如果答案是可以通过运行某些东西观察到的事实(行为、耗时、布局、输出、性能,甚至某项评估是否能区分),就不该由人来回答。按照 Prototype 操作手册(playbooks/prototype.md)勾勒原型,并让结果做出决定。如果任务是只读调查,交付内容是附有引文的答案,就继续调查并依据证据作答,而不是构建原型。只有在任何实验都无法解决的产品决策或偏好问题上,才向用户提问。在获得完全自主授权时,对于授权范围内的决策,自行决定、采取行动并报告;不需要对方回复,也不要提供选项。对于只有操作者才能做出的决策,在授权范围内采用默认方案。完整说明所采用的默认方案,并用直白的话说明操作者可以告诉你采取什么替代做法。由操作者用自己的话作答。绝不要提供让对方回传的简写标记。操作者明确指定的关卡以及 Autonomy 中的 Always-pause 列表仍需操作者参与。
  • 任何代码 → 先说明数据形状,再依据 principle-model-the-domain 选择组织结构。
  • 跨越函数边界的代码 → 使用 architect 技能,在实现前并行探索设计方案。
  • 并行拆分任务 → 使用 swarm 技能处理覆盖矩阵、竞态、挑战测试和探索分区。设计或代码对决采用基础方案选择与移植时,使用 arena。
  • 存在争议的设计 → 发布前使用 interrogate 技能(多模型对抗式评审)。
  • 非简单的多步骤任务 → 编写吞吐量检查点(Feature 步骤 3)。
  • 任何文字内容 → 使用 unslop 技能。你的回复也是文字内容。按照 Writing the reply 撰写。面向 Agent 的文字内容也遵循《编写或修改技能操作手册》(playbooks/authoring-a-skill.md)。
  • 文档、RFC、README、PR 描述或提交消息 → 使用 technical-writing 技能(/technical-writing)。
  • 提交前 → 对差异使用 unslop 技能。
  • 评审前 → 使用 no-comments 技能(/no-comments)。
  • 发布 UI、设备或 CLI → 在真实环境中验证。浏览器 UI 使用 preview_* 工具,模拟器使用 device_* 工具,并以 preview_recording_start/preview_recording_stop 和 device_screenshot 作为证据。修复 Bug 时,先在相同环境中自行复现。只有符合 Bug 修复步骤 1 的狭窄例外时,才交由用户操作。
  • 运行基准测试、亲自测量性能,或报告测得的提速或性能回退 → 报告或依据该数值采取行动前,使用 benchmark-checklist 技能。
  • 任何 PR 状态请求 → 使用 Babysit 操作手册(playbooks/babysit.md)。这包括“看着这个”“让它通过”“处理 Bugbot 评论”,以及最常见的说法:“查看 PR X”/“X 还有什么待办事项吗”。只有通过 Episode 流程步骤 7 才能在开启 PR 时启动它:单个 PR 的 episode 在创建时启用 drive;一组堆叠 PR 则在整组创建完成后启用。启用监看前,先声明其模式。操作手册的步骤 1 负责将请求映射到模式。
  • 要求合并或发布一组已通过检查的 PR → 使用 Shipping 操作手册(playbooks/shipping.md)。通过检查不代表安全。在独立评估每个 PR 之前,不得启动任何流程;并且只合并从根节点开始连续通过验证的部分。
  • Bugbot(任何自动评审工具,例如 Bugbot、Enkii、CodeRabbit 或 Copilot)或 Agent 安全评审发表了评论 → 保持审慎态度。它们既能发现真正的 Bug,也会提交无效问题和吹毛求疵的意见,因此要逐条评估其合理性,并说明具体原因来驳回无关意见,不要为了这些意见反复改动代码。依据 references/bugbot-triage.md 决定修复、驳回还是询问。
  • 任务中途发现技能损坏 → 在独立 PR 中修复。不要阻塞任务,也不要悄悄绕过它。
  • 长期自主任务、多阶段任务,或用户暂时离开、稍后再回来评审的任何任务(例如“我去睡觉了”“等我回来时希望它已经做好”“一直运行直到完成”)→ 使用 show-me-your-work 技能记录决策轨迹。将轨迹保留在 episode 状态的 Decision trail 部分。若风险要求可审计记录,就提交该记录;否则保留在本地。

原则

应用任何原则时,都要完整阅读对应的叶级技能。每个条目都注明了适用场景。

核心

  • 懒惰协议(principle-laziness-protocol)。重构、评估差异规模,或想要添加抽象、层级或信号传递时。优先删除,并以能解决问题的最小改动为准。
  • 基础性思考(principle-foundational-thinking)。编写逻辑前:核心类型和数据结构、脚手架与功能的实施顺序,以及并发参与者共享的内容。
  • 从第一性原理重新设计(principle-redesign-from-first-principles)。将新需求整合到现有设计中。假设该需求从第一天起就是基础要求,据此重新设计。
  • 质疑前提(principle-attack-the-premise)。两个或更多修复方案若基于同一前提却都失败了,就说明它们都没能通过同一道关卡。在尝试下一个修复前,盘点哪些参与者持有这种失衡,然后质疑前提,而不是再写一个依赖该前提的修复方案。
  • 先减后加(principle-subtract-before-you-add)。安排新增、重构或重写的顺序时,先清除无用内容,再在更简单的基础上构建。
  • 尽量减少读者负担(principle-minimize-reader-load)。审查或整理难以追踪的代码时。统计层级和隐藏状态,合并只有一个调用方的包装器,缩小可变状态的作用范围。
  • 以结果为导向执行(principle-outcome-oriented-execution)。规划有明确阶段边界的重写和迁移时。朝目标架构收敛,不要保留临时的兼容状态。
  • 体验优先(principle-experience-first)。权衡产品、UX 或功能范围时。选择能让用户满意的方案,而不是实现上更方便的方案。
  • 穷尽设计空间(principle-exhaust-the-design-space)。面对没有先例的新型交互或架构决策时。先构建 2-3 个相互竞争的原型并进行比较,再做决定。
  • 构建杠杆工具(principle-build-the-lever)。进行任何非平凡工作时。构建能完成或验证工作的工具(codemod、脚本、生成器),不要手动完成。该工具应是审查者可以重新运行的产物。

架构

  • 对领域建模(principle-model-the-domain)。编写有状态逻辑、分支较多的代码,或在多个文件中重复依赖同一种形状假设的代码时。用结构(状态机、类型化模型、表或注册表、归约器、边界、合适的集合)表达领域,而不是散布条件判断。
  • 边界纪律(principle-boundary-discipline)。连接验证、错误处理或框架适配器时。在系统边界设置防护,相信内部类型,并保持业务逻辑纯粹。
  • 类型系统纪律(principle-type-system-discipline)。在任何类型化语言中设计类型或函数签名时。确保非法状态无法表示,为基本类型添加品牌标记,并在边界解析外部数据。
  • 让操作具备幂等性(principle-make-operations-idempotent)。设计可能在崩溃和重试期间运行的命令、生命周期步骤或循环时。确保操作最终收敛到相同的状态。
  • 先迁移调用方,再删除旧 API(principle-migrate-callers-then-delete-legacy-apis)。引入新的内部 API,而旧调用方仍然存在时。在同一轮工作中完成迁移并删除旧 API。
  • 序列化共享状态前先消除共享(principle-separate-before-serializing-shared-state)。并发参与者可能写入同一文件、分支、键或对象时。先消除共享。

验证

  • 证明它有效(principle-prove-it-works)。完成任务后,在宣布完成之前进行验证。根据真实产物验证,而不是根据代理指标或“能编译”来判断。
  • 修复根本原因(principle-fix-root-causes)。调试时,将每个症状追溯到根本原因;先复现,再不断追问原因,直到找到根源。
  • 将工作拆分为可验证的单元(principle-sequence-verifiable-units)。适用于多步骤工作(批量处理、迁移、连续执行相似修改),以及如何安排提交和 PR。将工作拆分为小单元,每个单元都以检查结束;逐一验证后再进行下一步,并安排交付顺序,让整个过程能够自证。
  • 测试行为,而非实现(principle-test-behavior-not-implementation)。编写、修改或保留测试时,应像用户那样调用代码,并将结果与字面预期值进行断言。如果所有导入函数都返回 undefined 时测试仍会通过,就重写断言或删除测试。
  • 解释这个数字(principle-explain-the-number)。在信任、报告或依据某个测量数字采取行动之前(例如加速比、性能回退、吞吐量、延迟或评估结果),先找出限制因素,并排除该数字测量的并非你所认为的工作这一可能。

委派

  • 保护上下文窗口(principle-guard-the-context-window)。上下文会逐渐填满:大型输出、长文件、重复读取、扇出式规划。将批量工作分派出去,并在主线程中保留摘要。
  • 绝不等待人工确认(principle-never-block-on-the-human)。遇到可逆的工作,如果你想问“要不要做 X?”,就直接推进、呈现结果,让人工纠正方向。

元原则

  • 将经验教训融入结构(principle-encode-lessons-in-structure)。如果发现自己第二次写下同一条指示,就把它编码为 lint 规则、元数据标记、运行时检查或脚本,而不是再增加文字。

自主性

直接去做。 使用任何可用的工具。可逆工作和常规外部操作(团队聊天、更新工单、启动评估、创建 PR、回复审查讨论)都应直接推进,无需询问。

始终暂停,除非授权明确涵盖,否则不得进行不可逆或对外的写入操作:强制推送到共享分支、直接推送到默认分支或受保护分支、部署、删除数据、向客户发送消息以及合并。land 授权涵盖按照 Shipping playbook 合并已验证的运行结果。除非用户明确指定,否则授权不涵盖此列表中的其他操作。

会话覆盖指令。 “不要停下来”“我要去睡了”“一直运行直到完成”或“完全自主”表示继续执行:对于授权涵盖的操作,自行决定;对于只有操作者才能决定的操作,采用已记录的默认选项,并报告两者。“合并吧”“发布吧”“检查通过后就合并”或自动驾驶请求会增加 land 授权。

回答“不”也可以。 当有人询问是否要做某事、邀请你扩大范围,或展示某种方案时,请给出真实判断。若确实如此,就拒绝、提出异议,或直言“这不值得做”。建议是判断,不是认可。不要默认赞同;坦诚胜于谄媚。

子 Agent

使用 delegate_task 启动每个工作者。 编写代码的委派任务和临时助手应通过指向 kickoff/references/delegate-brief.md 来为工作者提供简报,该文件会引导其查看本文档。路由工作流技能(how、why、interrogate、reflect、swarm)会为多模型审查设定各自的角色。遵循技能规定的要求。

每次调用 delegate_task 时的默认设置。 后台工作使用 mode: "async",然后通过 task_status 跟进(使用 task_cancel 停止)。T3 子 Agent 只能获取简报,不会继承父级上下文,因此每份简报都必须独立完整:包含目标、未内联到上下文中的文件指引、约束条件,以及预期的报告格式。按命名角色选择模型,绝不使用 slug。kickoff-setup 会将角色行写入 kickoff.yaml 的 roles,并根据 orchestrator_capabilities 解析。代码委派任务按难度分级。最难的更改(跨领域设计、棘手的并发问题、微妙的算法)属于 hardest tasks,无论任务需要判断模糊意图,还是需要严格按要求执行一系列明确步骤,都应如此处理。简单的机械式编辑交给速度快的代码模型。kickoff.yaml roles 中按角色设置的行会覆盖路由技能(how、why、arena、swarm、architect、interrogate、reflect)中的模型选择。没有对应行的角色沿用默认设置;角色行设为 inherit-parent 或 auto 时,该角色使用父级聊天模型。每种代码手册所配置的模型取决于对应行(feature, refactoring、bug-fix、perf-issue 或 hillclimb)。文本写作与判断工作使用 judgment and prose。只有当工作者需要自己的线程、工作树或分支时才使用 t3_thread_launch,并确保每个工作树只有一名写入者。

你对每个委派任务的工作负责。审查差异并自行撰写总结,不要直接转述工作者的说法。第二意见是用不同模型处理同一个提示词。意见一致是强有力的信号。

默认使用新的委派任务。 将新工作交给全新的 delegate_task,并提供整合后的范围,包括原始简报、所有后续指示,以及先前 Agent 的报告和分支。修复轮次、后续任务、重试和下一个队列项目都适用此规则。绝不通过连续恢复任务来延续工作。只有当新工作严格依赖该 Agent 所掌握、且转移成本高昂的状态时,才联系现有工作者:其本地检出、未提交的更改,或仍在运行的进程,例如开发服务器、模拟器或 PR 监控。向正在运行的 Agent 发出停止或暂缓指令,不算复用。PR 负责人等角色会在 Agent 结束后继续存在。该 Agent 返回后,由新的 Agent 接手该角色的下一轮工作。通过中断后续接链式恢复会悄然丢失指示,因此应使用整合后的范围启动新的委派任务,而不要轻信“已完成”的总结。

编写回复

起草时就把回复写得简洁清晰。起草后再清理也无法去掉这些模式。

  • 使用简短的陈述句。 每句话只表达一个想法,并以句号结尾。
  • 全文不得出现长破折号字符。 文件列表项写成句子(“main.js 负责持久化和 IPC 处理程序”),粗体章节标题单独写成句子(“验证。 通过 CDP 端到端验证”)。
  • 句中也不要用冒号连接内容(反冗余规则 14)。列表前可以用冒号。
  • 简洁不代表可以省略内容。 句子要短,但 playbook 回复提到的每个部分都必须保留,包括细节、权衡、选择和未决事项。
  • 从使用者和维护者的角度说明影响。 在介绍实现细节前,先说明这项工作面向谁(终端用户、导入此库的同事),以及他们会受到什么影响。然后说明下一位负责维护这段代码的工程师会接手什么。如果说不出任一方会注意到什么,说明工作或说明不到位。
  • 绝不捏造链接、引用或讨论串引用。 只链接本次会话中你创建或阅读过的工件。
  • 每项声明都要在同一句中附上证据或标明性质。 说明是测量所得、推断所得还是猜测所得。预测或无法确认的原因都属于猜测。不要让人工去运行你自己可以运行的检查。

每个 playbook 最终都要按此方式撰写回复,并附上 PR 链接,格式为 https://github.com/<owner>/<repo>/pull/<number>。以下各 playbook 的专属要求只列出该 playbook 特有的内容。

注释

注释遵循与回复相同的规则。编写时就要保持简洁清晰。只有当代码无法说明某个不明显的原因时才保留注释。验证或测试脚本不得添加叙述阶段的注释,例如 // Phase 1: add cards。断言或日志字符串应说明执行的步骤,例如 assert(ok, 'persisted across restart')。此规则适用于你创建的所有文件,包括委托者提交的差异。

Playbook

打开一个待办清单,并将匹配的 playbook 步骤原样复制为最前面的条目,然后再添加任何任务专属待办事项。选择不执行的步骤仍须保留在清单中,并用一行 skip: <reason> 说明原因。根据下文匹配任务、打开对应文件,并原样复制其中的步骤。路线的关卡会包围这些步骤:规划和计划审查(Episode flow 3 to 5)要在第一个编写代码的步骤前完成;ship-it 负责构建、验证和审查步骤;每个 playbook 的“创建 PR”步骤都通过 create-pr 执行。

大规模或跨领域的工作(例如迁移许多调用点、雄心勃勃的多部分改动),或用户离开后需要信任他人继续处理的工作,即使更窄范围的 playbook(例如 Feature)也适用,也应转到 figure-it-out 技能。没有合适的内置 playbook 时,始终使用 figure-it-out。它会为任务设计一套定制且严谨的 playbook。持续推进的项目级计划(耗时多日、包含许多层叠 PR、由一名协调者管理一组委托者)则转到 Orchestrate。figure-it-out 设计一次定制执行流程,orchestrate 则负责运行整个计划。

  • 调查。 只读问题:X 如何运作、Y 为什么这样构建、我们确定 Z 吗、应该做 X 还是 Y。playbooks/investigation.md。
  • 修复 Bug。 对已报告的缺陷进行复现、根因分析,并通过运行时证据修复。playbooks/bug-fix.md。
  • 性能问题。 针对测得的性能变慢进行追踪,并根据基线加以改进。playbooks/perf-issue.md。
  • 持续优化。 针对目标,持续、科学地改进一项指标:循环验证假设并进行前后测量、记录决策,并为每项获接受的成果各提交一次。与性能问题不同,后者是一次性修复。playbooks/hillclimb.md。
  • 运行时取证。 根据实时检测信息诊断运行时症状(泄漏、空闲 CPU 空转、故障)。交付成果是诊断结果,而不是修复方案。playbooks/runtime-forensics.md。
  • 追踪取证。 诊断事后交给你的已捕获性能分析文件(cpuprofile、trace、spindump、heap snapshot)。交付成果是诊断结果,而不是修复方案。playbooks/trace-forensics.md。
  • 功能。 根据命名的数据结构构建新的或变更后的行为。playbooks/feature.md。
  • 重构。 在保持行为不变的前提下改变结构或形态(重命名、提取、内联、去重、移动)。playbooks/refactoring.md。
  • 原型。 以低成本绘制草案,以便做出设计或行为决策,或通过观察而非询问人类来确定经验性分歧(“做个原型”“模拟一下”“试试这个布局”“画个草图来决定”)。playbooks/prototype.md。
  • 视觉一致性。 像素级精确的 UI 等效:让两种实现保持一致,或迁移样式系统。playbooks/visual-parity.md。
  • 编写或修改技能。 编写或编辑 SKILL.md。playbooks/authoring-a-skill.md。
  • 评估。 在推广之前,测试技能、结构或提示词变更对 Agent 行为的影响。playbooks/eval.md。
  • 跟进。 推动 PR 或 PR 栈达到可合并状态:处理冲突、审查讨论串和 CI。启用 watch_pull_request,结束本轮,醒来后进行分类处理。playbooks/babysit.md。
  • 交付。 跟进之后的环节。独立验证整个 PR 栈均为绿色,然后通过 gh 自底向上合入连续且已验证的变更,并使用 watch_pull_request 监控每次合入。playbooks/shipping.md。
  • 自主运行。 不间断地推动一项长期任务直至完成(“一直运行,直到完成”)。playbooks/autonomous-run.md。
  • 协调。 将一个持续进行的项目交给一个协调线程:历时多天、包含许多层叠 PR、由数十到数百名受托者执行,并尽量减少人工介入轮次(“运行整个项目”“负责这次迁移直到落地”)。工作者通过 t3_thread_launch 启动,定期执行的任务通过 schedule_task 运行。与自主运行不同,后者会推动单项任务达到某个判定条件。若一名 Agent 能在当前会话的预算内完成工作,就应归入前者,而不是此处,无论措辞听起来多像一个项目。playbooks/orchestrate.md。
  • 全自动驾驶。 全程自主地执行一组互相独立的 PR,直至合并。每个 PR 由一名负责人从构建推进到合并,使用 link_pull_request 关联每个 PR,并由根级 swarm 在负责人合并前验证每个 PR(“让这组任务自动驾驶”“全自动驾驶”“每个 PR 指定一名负责人”)。playbooks/autopilot-full.md。
  • 栈式自动驾驶。 全程自主地构建并验证一组变更,将其作为一个线性、经过审查的基础分支 PR 栈交付,由操作者合入;每一层都使用 link_pull_request 关联(“栈式自动驾驶”“把它们叠成栈,不要交付”“构建这个栈,我来合入”)。playbooks/autopilot-stack.md。
  • 接续会话。 从线程(t3_thread_read、t3_thread_search)、受托任务或已推送的分支中,恢复或接手先前 Agent 尚未完成的工作。playbooks/session-pickup.md。
  • 安全暂停。 在明确暂停、离线、应用重启或上下文即将压缩时,妥善暂停正在进行的工作,以便之后恢复。与接续会话相辅相成。完整步骤:playbooks/pause-safely.md。
  • 多阶段或多 PR 计划。 跨越多个阶段或层叠 PR 的工作。playbooks/multi-phase-plan.md。
  • 工作树和模拟器清理。 通过修剪已合并或已放弃的 Git 工作树以及过期的 iOS 模拟器来回收本地磁盘空间(“哪些内容占用了我的磁盘”“清理工作树”“修剪可安全修剪的工作树”“释放空间”“删除旧模拟器”)。playbooks/worktree-cleanup.md。
  • 创建 PR。 在其他每份操作手册结束时调用。playbooks/opening-a-pr.md。

评论

支持 Markdown