📌 Skill 基础信息
Skill名称:Status Progression(状态流转导航)
简称:status-progression
来源:社区第三方(Angriff36)
运行宿主:Claude-Code CLI
核心定位:基于用户自定义配置的状态工作流导航器,解决开发者在任务管理系统中"下一步该做什么状态"、"为什么状态转换失败"等流转决策问题,适合需要自定义工作流规则的敏捷开发场景。
🧩 内部核心组成
子Agent集合
【无公开信息】
斜杠命令
| 命令名 | 功能简述 |
|---|---|
| get_next_status | 分析当前状态并推荐下一个合适的状态 |
| query_workflow_state | 查询完整的工作流状态,包括流转选项和级联事件 |
| query_container | 检查实体状态(状态值和标签) |
MCP工具
Read:读取用户配置文件(.taskorchestrator/config.yaml)
模板文件
- config.yaml:用户自定义状态验证规则和工作流配置
- examples.md:自定义工作流示例和标签路由模式
- validation-errors.md:常见错误处理和修复模式
- config-reference.md:详细配置结构参考
Hooks钩子
【无公开信息】
规则约束
- 仅解释和导航,不进行状态验证(由StatusValidator处理)
- 完全依赖用户自定义配置,无硬编码流程
目录结构
.taskorchestrator/
├── config.yaml # 主配置文件
├── examples.md # 示例文件
├── validation-errors.md # 错误处理文档
└── config-reference.md # 配置参考文档
🛠 安装与启用方式
安装命令:
skills install --user Angriff36/task-orchestrator
前置依赖:
- Claude-Code CLI 环境
- 用户自建的 .taskorchestrator/config.yaml 配置文件
API/工具要求:
- StatusValidator(负责实际的状态验证)
- get_next_status 工具(负责状态推荐分析)
启动方式:通过自然语言触发,如:"What's next?"、"Can I move to X?"等问句
📋 标准工作流
- 用户输入指令:提出状态流转相关问题
- 配置读取:Skill读取用户config.yaml中的status_validation规则
- 工具委托:调用get_next_status分析当前状态并推荐下一步
- 结果解释:
- 成功推荐:显示推荐状态和流转路径
- 遇到错误:读取StatusValidator错误并解释用户配置规则
- 指导操作:建议用户使用manage_container进行实际状态变更
- 错误处理:如遇验证失败,解释具体规则限制和解决方案
典型链路:用户问"下一步" → 工具推荐 → 解释推荐 → 指导操作 → 如遇错误 → 解释错误原因
⚠️ 关键限制、缺陷、注意事项
平台限制:仅支持Claude-Code CLI,不支持其他Agent平台
Token消耗:需要读取多个配置文件,可能产生较高token消耗
适合项目:
- 需要自定义工作流的敏捷开发项目
- 有复杂状态流转需求的任务管理系统
- 需要解释性指导而非强制验证的场景
不适合项目:
- 简单线性工作流(过度复杂)
- 无状态管理需求的小型项目
- 需要强制验证和阻止非法流转的场景
已知坑点:
- 完全依赖用户配置质量,配置错误会导致错误指导
- 不进行实际验证,用户可能仍然会遇到StatusValidator阻止
- 需要用户预先设置完整的config.yaml文件
生产环境适用性:可作为开发辅助工具,但不适合作为核心状态管理组件
✅ 适用场景 & ❌ 不适合场景
✅ 适用场景:
- 开发团队需要自定义工作流规则的敏捷项目
- 需要解释状态流转规则和失败原因的教育场景
- 复杂项目中需要导航多路径状态流转的决策支持
- 需要了解"为什么不能这样做"的分析场景
❌ 不适合场景:
- 需要强制阻止非法状态转换的生产环境
- 简单固定的工作流(配置 overhead 过高)
- 无状态管理需求的简单任务跟踪
- 需要实时验证和阻止的严格合规场景
如何安装
skills install --user Angriff36/task-orchestrator通用安装教程:在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器,把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同,按下面操作即可:
- 打开工具自带的终端面板,或系统终端(macOS「终端」、Windows「PowerShell」、Linux「Terminal」)。
- 把上面的安装命令复制进去,回车运行,等待下载与注册完成。
- 重启或重新加载 AI 工具,让新安装的 Skill 被识别。
- 新建对话并触发:直接描述用途,或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版(macOS / Windows)
桌面版没有内置命令行,Skill 需通过 Claude Code CLI 安装。打开系统终端,先执行 npm install -g @anthropic-ai/claude-code,再运行上面的安装命令;完成后完全退出并重新打开 Claude。
Claude Code(终端 CLI)
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面,再在对话中引用该 Skill(/ 斜杠菜单或直接描述用途)。
VS Code(含 GitHub Copilot)
打开终端面板:菜单「终端 → 新建终端」,或快捷键 Ctrl+`(macOS 为 ⌃+`)。在终端里运行上面的命令;装完后执行「重新加载窗口」(Ctrl+Shift+P → Reload Window),让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板(Ctrl+`)即是内置终端。粘贴运行上面的命令,完成后在命令面板执行「Reload Window」刷新,再开始对话。
Windsurf
底部「终端」面板运行命令;也可直接使用其内置 Agent 终端,在对话侧执行安装。
其他工具(ChatGPT、本地脚本等)
不支持本地终端的产品,可先在本机终端完成安装,再在对话中描述该 Skill 的能力让其调用;不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。
Aitishiku.com