SuperAPI AI 工具集

maintain-workflow-using-unified

智能体与模型

查看项目

更新于 10-16 10:19

技能介绍

用途

本技能是 Unified runtime 的激活门,用于判断任务是否需要进入 Unified 工作流,并在进入后执行技能发现流程。它强调只有在用户显式激活 Unified 的情况下才启用;普通 repo 问答、普通 coding 请求、普通 debug 请求,以及未提及 Unified 的直接任务,应保持 direct mode。

主要能力

  1. 激活判断:识别用户是否显式调用 /brainstorm、/refine、/design、/plan、/build、/review、/ship、/save、/restore、/learn、/help,或明确说“使用 Unified 工作流”“按 Unified 来”“进入 refine / plan / build / review / ship 阶段”,或讨论 Unified 本身的启动、路由、技能合同或加载机制。
  2. 技能发现:在激活后,先读取 skills-router.json 获取轻量路由;只有 router 无法回答、需要完整库存或进入 full 模式时,才读取 skills-index.json。
  3. 任务特征分析:从阶段、产物类型、触发词、上下文信号、风险因素、loading tier 六个维度分析任务。
  4. 分级加载:按 light、standard、expanded、full 四个层级决定加载范围。
  5. 宣告与执行:输出 “Using [tier] tier: [skill-name] to [purpose] because [trigger/risk]”,并在当前平台加载技能;Claude Code 调用 Skill 工具,Codex 读取对应 skills/<name>/SKILL.md 或使用宿主暴露的技能入口。

使用方式

只有在用户显式进入 Unified 工作流、调用阶段命令,或提到 Unified 启动/路由/初始化时,才必须执行技能发现流程。流程包括:判断是否激活 Unified runtime;读取 skills-router.json;分析任务特征;选择 loading tier;查询相关技能;决策加载;宣告并执行。若未激活,则保持 direct mode,不读取 skills-router.json,不宣告 loading tier,也不为了“可能相关”而自动加载 Unified 阶段技能。

适用场景

  • 用户显式调用阶段命令,例如 /build、/review、/ship。
  • 用户明确要求使用 Unified 工作流或按 Unified 执行。
  • 用户在讨论 Unified 的启动、路由、技能合同或加载机制。
  • 需要根据触发词、上下文信号和风险因素决定加载哪些阶段技能。

限制

  • 当前 agent 是被派发的 subagent,且 <SUBAGENT-STOP> 已命中时,不使用本技能。
  • 用户只要求解释 Unified Skills 本身,不需要进入任务执行时,不使用本技能。
  • 当前平台已经由宿主自动完成等价技能发现,并提供了明确结果时,不使用本技能。
  • 用户只提出普通 repo 问答、普通 coding 请求、普通 debug 请求,但没有显式要求使用 Unified 工作流或阶段命令时,不使用本技能。
  • 如果用户明确说“跳过 X”,遵循用户指令;但用户只说“做 Y”不等于激活 Unified。
  • 技能文件读取失败时,记录失败,降级为 light tier(router-only),告知 human partner 技能不可用,不静默跳过。

验证与失败处理

验证清单包括:已完成激活门判断;未激活时保持 direct mode;skills-router.json 已读取;必要时才读取 skills-index.json;6 维度分析已完成;loading tier 已宣告;至少一个技能已宣告;无 Red Flags 触发。失败场景包括:用户没有显式要求使用 Unified、skills-router.json 无匹配结果、匹配到多个冲突技能、loading tier 不确定、技能文件读取失败、用户明确说“不用技能”,均按对应方式处理。