Menu
智能体工作流：单入口设计，所有任务从 router 开始 TRIGGER when: 开发、修复、规划、分析、审查、调研、实施 DO NOT TRIGGER when: 简单闲聊
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| 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 字段标识规划模式