技能使用指南

work(工作执行Skill)Skill 是什么?如何下载安装?

工作执行Skill(work)是让 AI 拉起 Agent Teams 并行交付的协调者技能:加载并校验计划、按任务生成专属队友、内置验证与审查门、执行后沉淀经验并归档。本文讲清安装路径、/work 与 --resume、--eco 用法、竞品对比与真实场景体验,帮你把 AI 编码升级为可复盘的团队交付。

工作执行Skillwork
8 个章节 约 16 分钟阅读 AI 智能生成

工作执行Skill(work):让 AI 从"单兵写代码"升级为"带团队交付"

  • 它是什么:一个"协调者"型 AI 技能。它自己不写一行代码,而是把一份计划拆成任务,生成多个专门的 AI 队友并行实现,最后统一验证、归档、汇报。
  • 核心机制:加载计划 → 校验计划 → 创建团队 → 并行生成队友(kraken / spark / build-fixer / explore / oracle / critic)→ 分配任务 → 验证结果 → 提取经验 → 清理归档。
  • 三种调用形态:按计划名执行、--resume 断点续跑、--eco 经济模式;没有计划时还能"直接从一句描述开工"。
  • 最大差异点:它不是"更快地写代码",而是"用工程化的组织方式写代码"——文件所有权、依赖排序、验证门、安全审查、经验沉淀一个都不少。
  • 适合谁:手上已有设计/计划文档、需要多文件改动、希望过程可追溯可复盘的开发者与技术负责人。

1. 该技能叫什么?如何下载安装 AI 技能提升开发效率?

基本信息

项目 内容
中文名 工作执行Skill
英文名 work
技能ID 11577
角色定位 执行团队领导 / 团队协调员
调用入口 Claude Code:/work ...;Codex:使用 $work ...

它解决什么问题

传统 AI 编码是"一个会话、一个模型、从头写到尾":上下文越写越挤,任务串行推进越来越慢,改完没人验证,做完没有记录。工作执行Skill 把这件事改成"项目经理模式"——先有一份写清楚目标、任务、验收标准的计划,再由它拉起一支 AI 小队并行干活,每一环都有检查点。它解决的是从"能让 AI 写代码"到"能让 AI 稳定交付一件事"之间的落差。

一键安装的思路与步骤

  1. 准备前提:需要一个支持 Agent Skills 与 Agent Teams(子代理)能力的宿主环境,例如 Claude Code 或 Codex。这类环境通常还需要本地的文件读写、命令执行与子代理调度能力,否则协调者无法拉起队友。
  2. 放置技能文件:按技能详情给出的规范路径,技能应落在项目的 .agents/skills/work/ 目录下;在 Claude 环境中通过镜像目录 .claude/skills/work(符号链接)指向同一份技能,保证两种入口读到的是同一套逻辑。
  3. 确认工具映射:在 Codex 环境下,协调者会使用 exec_command 配合 rg、find 做仓库读取与搜索,使用 spawn_agent、send_input、wait、close_agent 完成委派与协作,必要时通过 request_user_input 向用户确认重大决策。
  4. 验证是否生效:在 Claude Code 中输入 /work,或在 Codex 中输入 使用 $work ...。若技能已正确加载,你应当看到协调者角色被激活,并开始检查计划目录、向你询问要执行哪个计划——这就说明生效了。
  5. 配套准备(建议):准备好计划目录(.maestro/plans/ 或 Claude Code 原生的 ~/.claude/plans/)。技能会同时从这两处读取计划,同名时优先使用 .maestro/plans/ 版本。

说明:技能市场/插件市场的具体下载入口、安装命令与是否收费,请以官方说明为准;本文只描述技能详情中已明确给出的路径与调用方式。


2. 该技能的主要功能和特点

  • 纯协调、不越权:技能明文规定"委派所有实现,你从不直接编辑文件"。所有编辑动作由队友完成,协调者只负责任务拆解、分配、验证与收尾。这条约束让执行过程天然具备"分工 + 复核"的双重保险。
  • 多来源计划加载与智能匹配:同时扫描 .maestro/plans/*.md 与 ~/.claude/plans/*.md。原生计划文件名是随机生成的(类似 curious-hopping-fairy.md),因此它还会读取计划的一级标题做不区分大小写的子串匹配,让你用"标题里记得的那几个字"就能叫出计划。
  • handoff 状态协同:通过 .maestro/handoff/*.json 记录设计态与执行态。若检测到 status: "designing" 的交接文件,会主动警告"设计尚未定稿";执行开始写 executing,完成后写 archived 或 completed,全程状态可追溯。
  • 计划体检:对 maestro 计划强制校验 ## Objective、## Tasks(至少一个未勾选任务)、## Verification,缺一项就停下;对结构更松散的原生计划只硬性要求"存在可执行复选框",其余缺失仅告警不拦截。
  • 并行生成队友:一次性发出多个 spawn_agent 调用,而不是一个接一个生成,队友之间通过共享任务列表自我协调。
  • 按任务类型选人:kraken 负责 TDD 与多文件新功能,spark 负责单文件快改与配置更新,build-fixer 处理构建/编译/lint/类型检查错误,explore 做代码库研究,oracle 做战略决策,critic 做实施后审查。
  • 文件所有权防冲突:从计划中提取每个任务涉及的文件路径写入任务描述,避免把重叠文件的任务同时派给不同队友;无法避免时用依赖关系强制串行。
  • 经济模式 --eco:简单修复与只读研究路由到 haiku,复杂 TDD 任务路由到 sonnet,并跳过 oracle 与 leviathan,用更低成本跑完同样的流程。
  • 断点续跑 --resume:只为未勾选任务创建任务,已完成的直接跳过,并汇报"N 完成,M 剩余"。
  • 无计划也能干活:参数不像计划名时,会用启发式规则判断它是不是一段工作描述(含空格、长度超过 40 字符、含 add/fix/create/update/implement/refactor 等动词),是则直接进入无计划流。
  • 三道质量闸门:验证协议(读文件 + 跑测试)、安全审查(自动触发)、批评者审查(任务数或文件数超过 5 时启动,输出 APPROVE / REVISE 裁决)。
  • 经验沉淀与收尾:结束时抽取可复用经验,把执行摘要写入 .maestro/notepad.md 的工作记忆区,归档计划、清理团队、输出完成报告。

3. 如何使用该技能?

第一步:加载计划

在 Claude Code 中输入 /work,或在 Codex 中输入 使用 $work ...。

  • /work my-login-plan —— 按名称加载指定计划;
  • /work —— 只有一个计划时自动加载,多个时弹出选择;
  • /work --resume —— 恢复被中断的执行;
  • /work --eco —— 以经济模式执行。

若存在设计中的交接文件,技能会提示设计可能尚未定稿,并询问继续还是停止。

第二步:确认计划

技能会展示计划标题、来源(maestro 或原生)、目标摘要、任务数量与范围摘要,然后询问"执行此计划?"。你选择"是,执行"才会进入下一步。

第三步:创建团队与任务

技能先以 work-{计划名} 为名创建团队,再把计划中的每个复选框转成共享任务,任务描述里带上完整说明、验收标准、相关文件路径、约束条件,以及必要的优先上下文。任务之间存在先后关系时,通过依赖设置来排序。

第四步:生成队友并派活

协调者一次性并行生成 2–4 个队友,然后显式派发第一轮任务;第一轮之后,队友在完成任务时自行领取下一个任务。

第五步:过程监控与验证

每完成一个任务,协调者都会读文件、跑测试、检查是否引入新错误;涉及安全敏感改动时会触发安全审查;大计划还会追加 critic 审查。裁决为 REVISE 时,具体问题会被打回给责任队友并等待修复。

第六步:收尾

抽取经验 → 写执行摘要 → 关闭并清理所有队友 → 归档计划(maestro 计划移到归档目录,原生计划原地勾选完成)→ 输出完成报告,包含任务完成情况、文件变更、测试结果、归档位置与后续建议,并提示可用 /review 做验收复核。

输入示例与输出说明

你可能输入 预期行为
/work auth-refactor 按文件名或标题匹配加载 auth-refactor 计划并执行
/work 给用户模块增加手机号登录并补测试 判定为工作描述,进入无计划流直接开工
/work --resume 跳过已勾选任务,只做剩余部分
/work --eco 用低成本模型路由跑完整流程

输出结果通常包含:变更文件清单、测试通过情况、审查裁决、经验条目、归档路径,以及可选的合并指令(启用工作树隔离时)。


4. 同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
工作执行Skill(work) 多队友并行执行的"项目经理" 计划加载与校验、并行生成队友、任务依赖、文件所有权、验证与审查门、经验沉淀、归档报告 需支持 Agent Teams 的宿主;需 .agents/skills/work/ 路径与计划文件 多文件改造、已有计划的落地执行、需要过程可追溯 优势:流程完整、职责清晰、可复跑可复盘;不足:依赖计划质量,重流程对一次性小脚本偏重
通用 AI 编码助手单会话直写 单个 AI 边想边写 对话式生成与修改代码 最低,装好编辑器或 CLI 即可 快速验证想法、单文件小改动 优势:上手快、无流程负担;不足:上下文易膨胀、串行慢、缺少独立验证与归档
编辑器内置 Agent 模式 编辑器内的自动改写 多文件编辑、终端命令、内联补全 低,随编辑器安装 日常迭代、局部重构 优势:与编辑器深度集成、反馈即时;不足:缺少团队级任务编排与角色分工,复盘能力弱
自建多代理编排框架 自行编写代理协作逻辑 自定义代理、流程编排、工具接入 高,需要自行搭建与维护 有平台团队、需要深度定制的场景 优势:完全可控、可贴合内部规范;不足:建设与维护成本高,质量门与经验沉淀需自己补

横向看,工作执行Skill 的差异不在"能不能写代码",而在"能不能把一件事拆开、分给合适的人、并证明它做对了"。


5. 该技能的典型应用场景与实际体验情况

场景一:独立开发者遇到跨多文件的中型需求

角色:独立开发者。痛点:需求涉及接口、服务层、测试三处改动,单会话写到后面已经记不清前面改了什么。使用方式:先用 /design 或模板写出带目标、任务清单、验收标准的计划,再 /work 计划名。实际体验:上手难度中等,主要成本在"写计划"这一步,但协调整者会替你完成拆任务、并行派活、逐项验证;效果上,改动被拆成可独立验收的小块,任何一块失败都能定位到具体队友与具体文件;注意事项是计划里的任务粒度不要太大,否则队友之间容易出现文件争用。

场景二:技术负责人落地已经评审通过的设计

角色:技术负责人。痛点:设计文档写得很漂亮,落地时全靠人工拆活派活。使用方式:设计阶段产生的交接文件会被自动识别,技能会把最近完成的计划标记为推荐项排在首位,确认后直接执行。实际体验:交接状态与计划归档让"设计—执行—验收"形成闭环,执行摘要落在工作记忆区,回顾时不必翻聊天记录;注意事项是若检测到设计仍在进行中,应先补完设计再执行,否则计划可能不完整。

场景三:老项目批量修复构建与类型错误

角色:维护老项目的工程师。痛点:lint 与类型检查报错成片,逐个修耗时且枯燥。使用方式:/work --eco,由 build-fixer 与 spark 承担修复,简单任务走低成本模型。实际体验:经济模式在批量小修场景下体感最明显,成本下降而流程不变;注意事项是修复类任务同样要过验证门,不要为了省时间跳过测试,否则容易把编译通过误当成逻辑正确。

场景四:执行被中断后继续

角色:任何赶进度的开发者。痛点:跑到一半被打断,重跑又怕重复劳动。使用方式:/work --resume。实际体验:已勾选任务被直接跳过并给出"完成数与剩余数"的摘要,几乎无缝续跑;注意事项是中断期间如果手动改过文件,建议先确认勾选状态与实际代码一致,避免"标记完成但代码没落地"的错位。

总体体验结论:上手难度中等偏上——难点不在命令,而在"愿不愿意先写清楚计划";效果上限很高,因为流程里内置了验证、审查与归档;最常见的坑是任务粒度过粗导致文件争用、以及跳过验证门直接收工。


6. 该技能能为用户带来的价值

把"能写"变成"能交付"。它把一次 AI 编码从"对话"变成"项目":有目标、有任务、有验收、有归档。对个人开发者,这意味着少做一遍"改完再自查"的重复劳动;对团队,这意味着执行过程第一次变得可以被复盘。

并行带来的时间收益。多个队友并行推进不同任务,原本需要串行完成的多文件改动可以同时展开;同时 --eco 让简单任务走低成本模型,把预算留给真正复杂的 TDD 工作,成本与速度可以按需调节。

流程内置的质量下限。验证协议、安全审查、批评者审查构成了三道闸门。它们不一定让结果更聪明,但能显著减少"看起来完成了其实没完成"的情况,也减少"跑通了但引出了新问题"的返工。

降低协作门槛。角色分工用一张表就说清楚了:谁做 TDD、谁做快改、谁修构建、谁做研究、谁做审查。即使你并不熟悉多代理系统,也能按表派活,不需要自己设计调度逻辑。

长期价值在积累。每次执行都会抽取经验、写入工作记忆、归档计划。跑得越多,.maestro/notepad.md 里的约束与陷阱记录越厚,后续执行踩坑越少;归档的计划也让"当初为什么这么改"有据可查。这种可累积性,是单次对话式编码难以提供的。


7. 常见问题 FAQ

Q1:这个技能怎么安装?装到哪里才算生效?

按技能详情,规范路径是 .agents/skills/work/,Claude 环境通过 .claude/skills/work 符号链接指向同一份技能。装好后在 Claude Code 输入 /work、在 Codex 输入 使用 $work ...,若能被识别并开始检查计划目录,即为生效。具体下载入口与安装命令请以官方说明为准。

Q2:它收费吗?

技能本身是否收费、是否随宿主环境一并提供,详情中并未说明,请以官方说明为准。需要提醒的是,执行过程会调用多个子代理,成本取决于你选择的模式:默认模式会用到更高能力的模型,--eco 经济模式则把简单任务路由到低成本模型,按需选择即可。

Q3:它适合谁用?新手能直接上手吗?

适合已有计划或设计文档、需要多文件改动、希望过程可追溯的开发者与技术负责人。新手也能用,因为命令本身很简单,但要想发挥价值,需要先学会写一份结构完整的计划(目标、任务清单、验收标准)。如果只是改一个文件里的几行代码,用普通对话式编码更划算。

Q4:它和编辑器里的 Agent 模式、自建多代理框架怎么选?

要"快",选编辑器 Agent 模式;要"可控且可深度定制",选自建编排框架;要"有人拆活、有人干活、有人验收"的完整执行链路,选工作执行Skill。三者不冲突,很多团队是日常小改用编辑器,成规模的需求交给它跑。

Q5:执行到一半中断了怎么办?会不会重复劳动?

用 --resume 恢复。技能只会为未勾选的任务创建任务,已完成的自动跳过,并给出完成数与剩余数的摘要。若中断期间你手动改过代码,建议先核对勾选状态与实际文件是否一致,再续跑。