Menu
智能体工作流：单入口设计，所有任务从 router 开始 TRIGGER when: 开发、修复、规划、分析、审查、调研、实施 DO NOT TRIGGER when: 简单闲聊
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | agentic-workflow |
| description | 智能体工作流：单入口设计，所有任务从 router 开始 TRIGGER when: 开发、修复、规划、分析、审查、调研、实施 DO NOT TRIGGER when: 简单闲聊 |
| version | 6.4.0 |
| tags | ["core","workflow"] |
| requires | {"tools":["Read","Write","Bash","Grep","Glob"]} |
planning_mode 字段标识规划模式 (canonical/legacy/lightweight)thinking_methods 和 thinking_mode 追踪思考方法论research_summary 跨阶段持久化传播| 用户关键词 | 路由到阶段 |
|---|---|
| "bug"/"错误"/"修复" | DEBUGGING |
| "计划"/"拆分"/"规划" | PLANNING |
| "最佳实践"/"怎么做"/"如何" | RESEARCH |
| "审查"/"review"/"质量" | REVIEWING |
| "优化"/"迭代"/"精炼" | REFINING |
| "试验"/"想法"/"探索" | EXPLORING |
| 多模块/多文件任务 | FULL_WORKFLOW |
| "继续"/"resume"/"恢复" | 读 .workflow_state.json 恢复上下文 |
按复杂度自动选择最小必经阶段（禁止跳过）：
| 复杂度 | 示例 | 必经阶段 |
|---|---|---|
| XS | 改 typo、加 import | EXECUTING → COMPLETE |
| S | 修已知 bug | DEBUGGING → EXECUTING → COMPLETE |
| M | 新增 API | PLANNING → EXECUTING → REVIEWING → COMPLETE |
| L | 重构模块 | RESEARCH → THINKING → PLANNING → EXECUTING → REVIEWING → COMPLETE |
| XL | 设计新系统 | RESEARCH → THINKING → PLANNING → EXECUTING → REVIEWING → REFINING → COMPLETE |
skill_policy 是默认启用策略，skill_activation_level 是默认激活档位，use_skill 是它们的执行结果。当前主线默认策略如下：
| 阶段 | 默认策略 | 默认激活档位 | 说明 |
|---|---|---|---|
| EXECUTING | default_enable | 50%-75% | 全局基线 50%，M+ 75%，失败时可升级 |
| REVIEWING | conditional_enable | 50% | 优先文件级审查，要求 two-stage review 和 file:line 证据 |
| DEBUGGING | conditional_enable_after_optimization | 0%-25% | 小任务 0%，复杂故障 25%，先轻量排障，重复失败再升级 |
| RESEARCH | defer_or_lighten | 0% | 仅在需要外部事实时启用 |
| PLANNING | defer | 0% | XS/S 走 file-first 轻量计划，复杂任务再提升 |
| THINKING | disable | 0% | 默认禁用；但其阶段输出应包含调查结论、主要矛盾、阶段判断、局部攻坚点 |
| FULL_WORKFLOW | disable | 0% | 由各阶段分别决策，不直接整体开启 |
失败后，runtime 会把启用中的 skill 激活档位从当前档位逐步升级到 75%/100%，避免一开始就全量注入。
进度输出和状态摘要包含以下关键字段：
| 字段 | 说明 | 来源 |
|---|---|---|
planning_mode | canonical/legacy/lightweight | 标识规划链的完整度 |
thinking_methods | 调查研究/矛盾分析/群众路线等 | 当前使用的思考方法 |
thinking_mode | investigation_first/mass_line_iteration/contradiction_analysis | 思考模式 |
research_summary | 研究结果摘要 | Research阶段的findings |
evidence_status | verified/degraded | research证据质量 |
每进入新阶段时输出：
[N/M PHASE] 一句话描述当前目标
阶段完成时输出：
[N/M PHASE ✓] 一句话总结产出
进度内容渲染包含：
| 当前阶段 | 下一阶段 | 必读内容 |
|---|---|---|
| RESEARCH | THINKING | 读 .research/findings/findings_{session}.md（优先）或 .research/findings/findings_latest.md |
| THINKING | PLANNING | 先读当前 phase 上下文里的 memory_hints / memory_query / memory_intent，再输出调查结论/主要矛盾/阶段判断/局部攻坚点，最后基于分析结论拆分任务，生成 .specs/<feature>/spec.md / plan.md / tasks.md / .contract.json |
| PLANNING | EXECUTING | 逐项执行 .specs/<feature>/tasks.md；如有 memory_hints，优先复用历史失败模式与约束；task_plan.md 仅在 legacy 兼容场景投影 |
| EXECUTING | REVIEWING | 运行 git diff 查看代码变更，必要时参考 memory_hints 避免重复踩已知失败模式，并更新 .contract.json |
| REVIEWING | REFINING | 针对 issues 逐项修复，先检查 memory_hints / memory_query / memory_intent，再产出 .reviews/review/review_{session}.md |
以下响应明确禁止，遇到立即停止并重新分析：
| 禁止语句 | 原因 | 正确做法 |
|---|---|---|
| "我认为完成了" | 无证据声明 | 运行测试/git diff，给出证据 |
| "代码看起来不错" | REVIEWING 无实质内容 | 输出含 file:line 的具体意见 |
| "跳过 X 阶段直接做 Y" | 违反强制序列 | 按照强制阶段序列执行 |
| "根据我的知识..." (RESEARCH) | 跳过真实搜索 | 先执行 WebSearch；工具不可用时明确告知用户 |
# 推进到下一阶段
python3 scripts/workflow_engine.py --op advance --phase {NEXT_PHASE} --workdir .
# 查看当前状态
python3 scripts/workflow_engine.py --op status --workdir .
scripts/workflow_engine.py 是唯一权威 runtimescripts/middleware.py 目前仅用于实验和对照验证scripts/experimental/ 已归档，不作为可执行主线的一部分.workflow_state.json — 唯一可信的状态文件.specs/<feature>/spec.md — 需求与验收标准.specs/<feature>/plan.md — 技术方案与约束.specs/<feature>/tasks.md — 执行任务清单.contract.json — 履约契约（COMPLETE 门禁）task_plan.md — legacy 兼容投影，仅在旧 runtime 需要时使用.research/findings/findings_{session}.md — RESEARCH 输出的研究结果（THINKING 必读，目录版）.research/findings/findings_latest.md — 最近一次研究结果的便捷别名.reviews/review/review_{session}.md — REVIEWING 输出的审查意见（REFINING 必读，目录版）.reviews/review/review_latest.md — 最近一次审查结果的便捷别名~/.gstack — 历史设计SESSION-STATE.md — 仍由 memory_ops.py 维护，作为兼容 sidecar，不是权威状态源progress.md — 兼容进度侧边车，由 workflow runtime 同步NO PHASE SKIP — FULL_WORKFLOW 触发时禁止跳过任何必经阶段
NO FIX WITHOUT ROOT CAUSE — DEBUGGING 时禁止在未确认根因前修改代码
NO COMPLETE WITHOUT VERIFICATION — 禁止在未运行验证命令前声称任务完成
| 想法 | 现实 |
|---|---|
| "这是个简单问题，直接回答" | 简单问题也可能需要 DEBUGGING/REVIEWING |
| "先做再说，做完再计划" | PLANNING 在 EXECUTING 之前，顺序不可颠倒 |
| "用户没说要走完整流程" | FULL_WORKFLOW 触发词见上表，不需要用户显式声明 |
| "我已经知道答案了" | 先验证，再声称完成 |
| "REVIEWING 可以快速过一遍" | REVIEWING 必须运行 git diff + quality_gate + pytest |
宣称任务完成之前，必须：
git diff 确认实际变更无证据 = 未完成。不得仅凭"我认为完成了"声称完成。
铁律: 不定位根因不修复
执行步骤:
3次失败规则: 3次假设都错时,停止惯性调试:
输出格式:
症状: ...
根因: ...
修复: ...
回归测试: ...
优先级排序:
P0 (致命):
P1 (严重):
P2 (建议):
输出格式:
[文件:行号] 问题描述 (P0/P1/P2)
影响: [一句话]
修复: [建议]
自我检验:
时间限制: 如果审查超过20秒无发现,输出已有结果并停止
复杂度路由:
核心原则: 不只拆分任务,要生成多种方案
执行:
反模式: 禁止为XS/S生成完整spec-kit,禁止强制验证脚本
铁律: 先写测试再实现,先验证再声称完成
Boil the Lake原则: 完整性与AI能力成正比,不要省步骤
Fix-First决策:
Voice规则:
执行步骤:
验证: 运行测试确认,不要只说"完成了".
阶段方法论:
Quality Gate: 自问"能自信回答吗?"
执行:
铁律: 搜索不可用时直接说明,禁止静默降级
时间感知: 检查当前日期,趋势用年月
核心: 谁最懂这个?TA会怎么说?
Mandatory Think: 重大决策(git操作,阶段转换)前必须思考
回答格式:
完成阶段 - 收尾工作、自反思和状态更新 当前版本对齐 .workflow_state.json 状态管理 v1.2: 新增可选 learn 技能触发建议与总结摘要复用
调试阶段 - 系统化问题定位和修复 5步调试法：闻味道 → 揪头发 → 照镜子 → 执行 → 复盘 包含压力升级机制和7项检查清单 v1.2: 强化 context-aware 激活、memory_hints 复用与失败升级事件记录
执行阶段 - TDD 开发循环和代码实现 当前版本对齐 .specs/<feature>/tasks.md、.contract.json、run_tracker.py 和 step_recorder.py Reflexion 强化: mid-task reflection checkpoint + AgentSys 子 agent schema 验证 v1.3: 新增 memory_hints/memory_query/memory_intent 复用与阶段摘要回流
深度探索阶段 - 苏格拉底式追问挖掘用户深层想法 通过迭代追问发现谬误、局限、潜能和潜意识中的构思
产品咨询阶段 - 在开始编码前重构产品想法 问正确的问题，确保理解用户真正想要什么
规划阶段 - 任务拆分和计划制定 正式规划链: .specs/<feature>/spec.md → plan.md → tasks.md → .contract.json task_plan.md 已降级为兼容投影层，供旧 runtime/frontier 读取 v1.3: 新增 planning_mode 字段标识规划模式