skill-orchestrator（技能编排器）Skill 是什么？

技能编排器：让 AI 按「任务语言 + 状态」自动路由到正确工作流

• 一句话定位：技能编排器（skill-orchestrator）是任务管理系统里的「中央路由智能」，负责把 /task、/research、/plan、/implement 等命令，按任务语言和当前状态，精准派发给合适的工作流技能。
• 核心机制：先查任务（读取 specs/state.json），再校验状态是否允许该操作，然后按语言选择研究/实施技能，最后打包上下文并委托执行。
• 安全性突出：该技能只被允许使用 Read、Glob、Grep、Task 四个工具，本质上「只读 + 派发」，不直接改写代码或文件，把风险控制在执行环节。
• 上下文按需加载：通过 @ 引用按需加载 orchestration-core.md、state-management.md 等上下文文件，避免一次性塞入无关内容。
• 适合谁用：同时维护多种语言（neovim、latex、typst、markdown 等）项目、且已经用「状态机 + 任务编号」管理需求的中重度 AI 编程用户。

1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？

基本信息

项目	内容
中文名	技能编排器Skill
英文名	skill-orchestrator
技能ID	12887
触发方式	执行 /task、/research、/plan、/implement 命令时调用
允许工具	Read、Glob、Grep、Task

它解决什么问题？

在没有编排器的场景里，AI 编程助手面临三个典型困境：

1. 路由靠猜：用户敲了一个 /implement 259，AI 并不知道 259 号任务是 neovim 脚本还是 latex 文档，于是常常调用了一个「通用实施技能」，结果产出与项目约定不符。
2. 状态失控：任务还停留在 not_started，却被要求直接实施；或者任务已经 blocked，却仍然被派去做研究。缺少状态校验，流程就形同虚设。
3. 上下文搬运靠人：每次委托前，用户要手工贴一遍任务描述、research 产物路径、plan 路径，重复且容易漏。

技能编排器把这三件事收敛成一条固定的执行链路：查任务 → 验状态 → 判语言 → 打包上下文 → 委派 → 收结果。

一键安装的思路与步骤

说明：技能详情中未提供具体安装命令与市场链接，以下为通用流程，具体入口、命令与版本要求请以官方说明为准。

1. 确认前提：你的 AI 编程环境需要支持「技能（Skill）」机制，并具备调用 Read、Glob、Grep、Task 四类工具的能力；同时，任务管理系统需要存在 specs/state.json 这一状态文件（这是编排器识别任务的依据）。
2. 找到技能：在技能市场 / 技能库中搜索英文名 skill-orchestrator，或直接以技能ID 12887 定位该技能。
3. 一键安装：点击安装 / 添加按钮完成装载；若你的环境采用配置文件方式，则按官方说明把技能注册到技能目录中。
4. 确认工具权限：检查该技能的允许工具是否包含 Read、Glob、Grep、Task，缺少 Task 将无法完成委派。
5. 验证是否生效：在存在 specs/state.json 的项目中执行一次 /research <任务编号>。若编排器正常激活，你会看到它先读取状态文件、再弹出状态校验结果，并最终返回形如 {"status": "completed", "routed_to": "skill-researcher", ...} 的结果。若毫无反应，优先检查技能是否启用、上下文文件路径 .claude/context/core/orchestration/ 是否存在。

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

（1）任务查找：按编号还原完整上下文

给定任务编号，编排器会依次读取 specs/state.json、以 project_number 定位任务、提取语言 / 状态 / 项目名称 / 描述 / 优先级，必要时再读 TODO.md 补充信息。这意味着你只需要记住一个编号，其余信息由它自动补齐。

（2）基于语言的路由：不同语言走不同技能

任务语言	研究技能	实施技能
neovim	skill-neovim-research	skill-neovim-implementation
latex	skill-researcher	skill-latex-implementation
typst	skill-researcher	skill-typst-implementation
general	skill-researcher	skill-implementer
meta	skill-researcher	skill-implementer
markdown	skill-researcher	skill-implementer

这张路由表是本技能最核心的差异化能力：语言是路由键。neovim 任务一定会落到 neovim 专属的研究与实施技能上，不会被通用技能「误伤」。

（3）状态验证：把非法操作挡在门外

操作	允许的状态
research	not_started、planned、partial、blocked
plan	not_started、researched、partial
implement	planned、implementing、partial、researched
revise	planned、implementing、partial、blocked

这是一套轻量但严格的状态机。例如任务处于 not_started 时想直接 /implement，会被明确拒绝并提示当前状态与允许操作。

（4）上下文准备：标准化的委派数据包

编排器会为被委托技能准备统一结构的数据包，包含任务编号、名称、语言、状态、描述、已有产物路径（research / plan）以及可选的用户焦点提示。下游技能拿到的是一份「格式稳定」的输入，减少来回追问。

（5）统一返回与错误处理

返回结果固定包含 status（completed / partial / failed）、routed_to、task_number 与 result（产物列表 + 摘要）。出错时也不含糊：任务未找到给出建议、状态非法给出当前状态与允许操作、技能调用失败返回带错误详情的部分结果。

和普通工具比强在哪？

普通做法通常是「一个万能技能 + 用户口头指定」，靠模型自由判断；而编排器把路由规则、状态规则、上下文结构外部化、显式化，让行为可预期、可复现、可排查。

3. 如何使用该技能？

步骤 1：准备任务状态文件

确保项目根目录存在 specs/state.json，且其中至少有一条带 project_number 的任务记录，包含语言、状态、项目名称、描述、优先级等字段。

步骤 2：用斜杠命令发起请求

常见调用形态：

• /research 259 —— 对 259 号任务做研究
• /plan 259 —— 为 259 号任务生成计划
• /implement 259 —— 实施 259 号任务
• /task 259 —— 查看 / 推进任务本身

步骤 3：观察编排器的执行链路

它会按固定顺序推进：接收命令上下文（任务编号 + 操作类型）→ 在 state.json 中查找任务 → 校验状态 → 按语言确定目标技能 → 准备上下文包 → 通过 Task 工具调用目标技能 → 接收并验证结果 → 返回给调用者。

步骤 4：理解输入与输出

委托给下游技能的上下文包大致长这样：

{
  "task_number": 259,
  "task_name": "task_slug",
  "language": "neovim",
  "status": "planned",
  "description": "完整任务描述",
  "artifacts": {
    "research": ["path/to/research.md"],
    "plan": "path/to/plan.md"
  },
  "focus_prompt": "可选用户提供的焦点"
}

编排器最终返回给你的是：

{
  "status": "completed",
  "routed_to": "skill-neovim-implementation",
  "task_number": 259,
  "result": {
    "artifacts": [],
    "summary": "..."
  }
}

步骤 5：根据返回结果决定下一步

• completed：产物已生成，按 result.artifacts 查阅，继续推进下一个状态。
• partial：说明委派技能调用失败或只完成了部分动作，查看错误详情后重试。
• failed：通常是任务未找到或状态非法，按提示修正 state.json 或改用允许的操作。

步骤 6：需要更多背景时手动补充

若某次任务描述过于简略，可在调用时附带焦点提示（focus_prompt），让下游技能聚焦到你关心的那块内容。

4. 同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
技能编排器Skill（skill-orchestrator）	任务管理系统的中央路由层	任务查找、语言路由、状态校验、上下文打包、统一返回与错误处理	需支持 Skill 机制与 Task 工具，需存在 specs/state.json；安装以官方说明为准	多语言项目、按状态机推进的多步骤任务流	优势：路由与状态规则显式化，行为可预期；只读工具权限，风险低。不足：依赖状态文件规范，项目结构不规范时收益打折
手工指定技能	由用户在每次提问时点名技能	无自动路由，全靠人工选择	门槛最低，无需额外安装	任务量少、语言单一的小项目	优势：简单直接、零配置。不足：重复劳动多，易选错技能，无法做状态校验
自定义斜杠命令脚本	用脚本把命令映射到固定流程	命令到流程的静态映射	需要自行编写与维护脚本	流程高度固定的团队	优势：可控性强。不足：语言分支、状态分支需手写，扩展成本随组合数增长
通用 Agent 路由器	由大模型自主判断该调用哪个工具/子代理	基于语义的自由路由	依赖模型能力，通常无需额外配置	开放式、非结构化任务	优势：灵活、泛化好。不足：路由结果不可复现，缺少状态机约束，出错后难定位

可以看出，编排器的取舍很明确：牺牲一部分「自由度」，换取「确定性」。它不负责理解你的自然语言意图，只负责把已经结构化的任务，准确送到该去的地方。

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

场景一：多语言混合仓库的开发者

一位开发者同时维护 neovim 配置、latex 论文模板和 typst 排版项目。过去他用同一个实施技能处理所有任务，结果 neovim 任务常被写成通用 Python 风格。接入编排器后，只要任务的 language 字段标为 neovim，就会被路由到 skill-neovim-research 与 skill-neovim-implementation。

实际体验：上手成本主要在「把任务登记进 state.json」这一步，一次性配置后日常几乎无感。效果上最直观的变化是产物风格一致性明显提升。注意点：语言字段必须写准，写错了路由就会跑偏。

场景二：按状态机推进的多步骤任务

一个需求通常要经历「研究 → 计划 → 实施 → 修订」。过去容易出现「还没研究就直接实施」。现在编排器会在 /implement 时检查状态是否为 planned、implementing、partial 或 researched，否则直接拒绝。

实际体验：拒绝提示很具体，会告诉你当前状态和允许操作，学习成本低。对习惯「一路狂奔」的用户来说，前期会觉得被「卡住」，但这恰恰是它价值的来源。

场景三：上下文频繁丢失的长任务

长任务中，AI 常常忘记之前的 research 产物在哪。编排器在委托前会把 artifacts.research、artifacts.plan 路径一并打包，下游技能无需再问「研究文件在哪」。

实际体验：减少来回追问是体感最强的收益。注意点：产物路径要真实存在且写入状态文件，否则打包出的路径会是空引用。

场景四：团队共用的任务看板

多人协作时，任务编号是天然的对齐锚点。任何成员执行 /research 259，走的都是同一条路由、同一套校验规则。

实际体验：结果可复现性是最大亮点，返回结构统一，便于后续自动化汇总。注意点：state.json 需要避免并发写入冲突，建议配合版本控制使用。

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

• 效率提升：把「选技能、贴上下文、检查状态」三件手工活合并为一条自动链路。单次任务交接少则省下几次往返，任务越多、语言越杂，累积收益越明显。
• 门槛降低：新手不必记住「neovim 任务该用哪个技能」，只需记住任务编号和四个斜杠命令，路由知识被固化在技能里。
• 错误前置拦截：状态校验把非法操作挡在执行之前，避免在错误状态下产出无效工件、浪费模型调用。
• 结果可追溯：固定的返回结构（status / routed_to / task_number / result）让每次调用都有据可查，出问题能快速定位是「没找到任务」「状态不允许」还是「下游技能失败」。
• 长期价值：路由表与状态表是显式配置，新增一种语言、新增一个状态，只需扩表而非重写流程，可维护性随时间放大。
• 风险可控：仅允许 Read、Glob、Grep、Task，编排器本身不具备写入能力，把「改代码」这件事牢牢留在被委托的实施技能里。

7. 常见问题 FAQ

Q1：这个技能怎么安装？我搜不到怎么办？

A：在支持 Skill 机制的环境里，用英文名 skill-orchestrator 或技能ID 12887 检索并一键安装即可。若搜不到，通常是当前环境的技能市场源未包含该技能，具体安装入口、命令与版本要求请以官方说明为准。安装后请注意确认 Read、Glob、Grep、Task 四项工具权限齐全。

Q2：安装后执行命令没反应，怎么排查？

A：按三步查：一是确认技能已启用；二是确认项目里存在 specs/state.json，且任务记录带 project_number 字段；三是确认上下文文件路径 .claude/context/core/orchestration/orchestration-core.md 与 state-management.md 可被读取。三项都正常，基本就能触发。

Q3：收费吗？

A：技能详情中未包含任何价格与计费信息，本技能本身不涉及付费说明。实际是否产生费用，取决于你所使用的 AI 编程平台与模型调用策略，请以官方说明为准。

Q4：它和「让模型自己判断用哪个技能」有什么区别？

A：区别在于确定性。通用 Agent 路由靠语义自由判断，灵活但结果不可复现；技能编排器按语言表和状态表这两张显式规则路由，同样的输入必然得到同样的路由结果，且能拦截非法状态操作。如果你追求「流程稳定、结果可查」，选它；如果任务是高度开放、无固定结构的，自由路由更合适。

Q5：适合谁用？

A：适合已经采用「任务编号 + 状态机」管理需求、且项目涉及多种语言（如 neovim、latex、typst、markdown）的开发者与团队。如果你的项目只有一个语言、任务随手就做完，直接手工指定技能反而更省事。