前言¶
多步任务里，Agent 常见问题是：步骤拆得不稳、做完一步不知道要不要继续、失败时反复用同一招「空转」，或无限重试却不换思路、也不向人求助。这类行为很难靠单次 system prompt 兜住，需要一套可重复的循环规则。
下面介绍 SkillHub 社区 Skill triphasic-execution（坐标 @user_800d68d6/triphasic-execution，当前版本 5.19.1）。它把执行过程固定为 Execute→Review→Advance 三步循环，并写明空转、重试、换思路、求助之间的流转；同时对重试与空转设置了上限（各最多 3 次），避免 Agent 在无效路径上耗尽上下文。
这是什么¶
triphasic-execution 是一套面向 AI Agent 的执行框架 Skill，基于通用 SKILL.md 格式，由社区发布者 user_800d68d6 维护，在 SkillHub 上归类为 ai-agent，标签标明 requires_api_key=false（不依赖额外 API Key）。
一句话定位：用「执行 → 评审 → 推进」的闭环组织长任务，强化步骤规划与语义理解，并把失败与停滞时的处置写成强制约束，而不是留给模型即兴发挥。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_800d68d6/triphasic-execution
- API 坐标页：https://api.skillhub.cn/user_800d68d6/triphasic-execution
核心功能¶
以下能力均来自 SkillHub 公开简介，安装后具体指令以包内 SKILL.md 为准。
Execute→Review→Advance 三步循环¶
- Execute（执行）：按当前计划落实一步可验证的工作（改代码、跑命令、查资料等，取决于你的 Agent 能力）。
- Review（评审）：对照目标检查这一步是否真正推进了任务，而不是表面动作。
- Advance（推进）：根据评审结果决定下一步是继续原计划、调整计划，还是进入异常流转（重试、换思路、求助等）。
循环反复进行，直到任务完成或触发框架内的终止条件。
步骤规划与语义理解¶
Skill 侧强调「增强步骤规划能力」与「增强语义理解」：在执行前把目标拆成可评审的步骤，在 Review 阶段用任务语义判断「这一步算不算有效进展」，减少机械重复操作。
空转 / 重试 / 换思路 / 求助的流转规则¶
简介中明确四类状态及完整流转规则（细节在 Skill 正文）：
- 空转：执行了动作但未带来实质进展时的处理路径。
- 重试：在可恢复错误下再次尝试同一思路，但有次数上限。
- 换思路：重试耗尽或评审判定原路径无效时，改策略再继续 Advance。
- 求助：在约束仍无法满足时，转向用户或外部澄清，而不是无限循环。
强制上限¶
框架硬性约束：最多重试 3 次、最多空转 3 次。超过上限应停止无效循环，进入换思路或求助，避免长时间占用会话。
安装与启用¶
SkillHub 官方建议：先按安装文档配置 CLI，再用坐标安装到当前 Agent 的 skills 目录。
1、检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可使用官方一键脚本（完整安装含默认 Skill；仅需 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明：在受限网络环境中执行安装脚本时，需允许访问外网。
2、安装 triphasic-execution¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落到 ./skills/ 可能不被识别。
skillhub install @user_800d68d6/triphasic-execution --dir <你的 skills 目录>
SkillHub 文档给出的常见路径示例：
| 环境 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
也可先搜索再安装：
skillhub search triphasic-execution
skillhub install @user_800d68d6/triphasic-execution --dir <你的 skills 目录>
3、在 Agent 中启用¶
将 Skill 安装到对应目录后，按你所用客户端的 Skill 加载方式启用（多数环境需重启或刷新 Agent 后生效）。本 Skill 不要求 API Key。
SkillHub 页面提供的自然语言安装提示（可交给支持 Skill 的 AI 执行）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_800d68d6/triphasic-execution`。
典型用法¶
公开页面未附带独立示例仓库；用法本质是：在需要多步、可评审的任务中加载该 Skill，让 Agent 按 SKILL.md 中的 triphasic 规则组织每一轮 Execute→Review→Advance。
可复现的起步方式：
- 按上一节完成
skillhub install到当前 Agent 的 skills 目录。 - 在任务描述中说明目标与验收标准（便于 Review 阶段对齐语义）。
- 观察 Agent 是否在每步后做评审，并在失败时按「重试（≤3）→ 换思路 → 求助」流转，而不是无上限重复。
若需核对逐步指令，安装后阅读包内 SKILL.md 与引用文件即可。
适用场景与注意¶
适合谁
- 用 Cursor、Claude Code、Codex 等支持 Skills 的客户端，处理 refactor、排查 bug、跨文件改动等多步工程任务。
- 希望 Agent 在「卡住」时有明确出口（换思路或求助），而不是 silent loop。
限制与注意
- 框架约束的是执行节律与异常流转；能否真正完成工作仍取决于模型能力、工具权限与任务描述质量。
- 「最多 3 次重试 / 空转」是 Skill 层规则，若任务极难，可能较早触发求助，需要你在对话中补充信息。
- 版本以 SkillHub 为准（当前 v5.19.1）；升级可用
skillhub对同一坐标更新到 skills 目录。 - 社区来源（community），使用前可在 SkillHub 页面查看评分与下载量等信息（页面数据会变动，以站点为准）。
结尾¶
triphasic-execution 把长任务收成 Execute→Review→Advance 循环，并用重试、空转上限和换思路/求助规则限制无效消耗。若你正在为 Agent 多步执行找一套可安装的约束型 Skill，可从 SkillHub 安装 @user_800d68d6/triphasic-execution：
https://www.skillhub.cn/skills/user_800d68d6/triphasic-execution
