| name | using-agentic-workflow |
| version | 1.0.0 |
| description | Use before ANY task — routes the request through the agentic-workflow pipeline and loads the correct phase skill |
If you were dispatched as a subagent to execute a specific task, skip this skill.
STOP. Before responding to ANY user message, you MUST answer:
1. Is this a multi-step task, bug fix, feature, refactor, or research request?
2. If YES → apply agentic-workflow routing below.
3. If NO (pure Q&A, single-file trivial edit) → proceed directly.
YOU CANNOT SKIP THIS CHECK. Even "simple" tasks escalate.
路由规则（每次响应前检查）
| 场景 | 关键词 | 进入阶段 |
|---|
| 复杂任务/完整流程 | 开发/构建/设计/实现 | RESEARCH → THINKING → PLANNING → EXECUTING → REVIEWING → COMPLETE |
| Bug修复 | bug/错误/调试/失败/报错 | DEBUGGING → EXECUTING → COMPLETE |
| 项目规划 | 计划/规划/拆分/架构 | PLANNING → EXECUTING |
| 技术调研 | 最佳实践/选型/怎么做/调研 | RESEARCH → THINKING（调查研究 → 矛盾分析 → 阶段判断） |
| 代码审查 | 审查/review/检查/分析 | REVIEWING |
| 继续上次 | 继续/resume/恢复 | 读 .workflow_state.json 恢复 |
| 简单任务 | 其他（单文件改动/明确小任务） | 直接 EXECUTING |
进度格式（强制）
每进入新阶段时 必须 输出：
[N/M PHASE] 一句话描述当前要做什么
阶段完成时：
[N/M PHASE done] 一句话总结产出
阶段上下文传递（强制）
| 当前阶段 | 必须传给下一阶段 |
|---|
| RESEARCH | .research/findings/findings_{session}.md（优先）或 .research/findings/findings_latest.md — THINKING 开始前读取 |
| THINKING | 调查结论 / 主要矛盾 / 阶段判断 / 局部攻坚点 → PLANNING 基于结论创建 .specs/<feature>/spec.md / plan.md / tasks.md / .contract.json |
| PLANNING | .specs/<feature>/tasks.md / .contract.json → EXECUTING 逐项执行；task_plan.md 仅 legacy fallback |
| EXECUTING | 代码变更 → REVIEWING 运行 git diff |
| REVIEWING | .reviews/review/review_{session}.md（优先）或 .reviews/review/review_latest.md → REFINING 针对性修复 |
Iron Law
NO PHASE SKIP — FULL_WORKFLOW 触发时禁止跳过任何必经阶段
NO FIX WITHOUT ROOT CAUSE — DEBUGGING 时禁止在未确认根因前修改代码
NO COMPLETE WITHOUT VERIFICATION — 禁止在未运行验证命令前声称任务完成
Red Flags（自我检查）
如果你有以下想法，立刻停止 — 你在走捷径：
| 想法 | 现实 |
|---|
| "这是个简单问题，直接回答" | 简单问题也可能需要 DEBUGGING/REVIEWING |
| "先做再说，做完再计划" | PLANNING 在 EXECUTING 之前，顺序不可颠倒 |
| "用户没说要走完整流程" | FULL_WORKFLOW 触发词见上表，不需要用户显式声明 |
| "我已经知道答案了" | 先验证，再声称完成 |
| "REVIEWING 可以快速过一遍" | REVIEWING 必须运行 git diff + quality_gate + pytest |
搜索工具降级策略
RESEARCH 阶段按可用性自动降级：
- WebSearch — Claude Code 原生，最优先
- WebFetch — 已知 URL 时使用
- AI 知识库 — 所有搜索工具不可用时，必须明确告知用户，不得静默使用自身知识
验证前禁止完成
宣称任务完成之前，必须：
1. 运行相关测试（pytest / npm test）并看到通过结果
2. 对于代码变更：运行 `git diff` 确认实际变更
3. 对于 REVIEWING：输出含具体 file:line 的审查意见
无证据 = 未完成。不得仅凭"我认为完成了"声称完成。
