claude-workflow

Use when 用户调用 /design-plan, or 需要为复杂跨服务需求(多服务改动 / 数据库 DDL / 新增对外接口 / 架构调整)产出可评审的技术方案文档,典型用户是技术主管 / 资深研发。简单单服务改动走 /workflow-spec,Bug 修复走 /fix-bug。

Use when asked to review a diff, do a pre-commit code review, or review staged/branch changes. Supports staged diffs, branch diffs, and session mode that reviews only files edited in the current conversation context.

Use when 用户调用 /plan-archive, or 三阶段研发流程的阶段三:在所有模块研发上线后,根据实际代码改动回写阶段一技术方案 + 项目级架构文档(docs/architecture / docs/contracts / docs/assets/概要设计 等)。

Use when 用户说「快速规划」「轻规划」「不走 workflow」「plan 一下」「quick plan」, or 需求清晰、作用域明确、可一次性规划完成的简单到中等任务。复杂项目(跨 module / 新子系统 / 需追溯)或需要正式需求文档 / PRD 请用 /workflow-spec。

Use when 用户调用 /spec-bootstrap, or 项目尚未建立 .claude/code-specs/ 骨架且需要初始化 code-specs 体系。

Use when 用户调用 /spec-update, or 工作中沉淀出新 convention / 接口 contract / 模式需要落到 .claude/code-specs/, or execute 末尾终审（workflow-execute Step 7）建议沉淀 code-spec。

Use when 用户说「补充前端设计」「UX 深化」「页面 flowchart」「布局提取」「补 §4.4」, or workflow-spec Step 5 确认需要前端设计深化, or 已有 Spec 需要补充 User Flow / Page Hierarchy / Layout Anchors。

Use when 用户调用 /workflow-spec, or 提出新需求要走完整 spec → plan → execute workflow, or 用户描述"完整需求规格 / spec → plan → execute / 跨 module 新需求"等场景。简单任务请用 /quick-plan。

Use when 同阶段存在 2+ 可证明独立的问题域：独立 bug 调查、多个失败测试文件、独立子系统的 trace/diagnose/research/analysis（只读 fan-out），或无共享状态、文件不重叠的独立写任务（writable fan-out）。每域一个 subagent，主会话汇总 + conflict check。禁止多 agent 编辑同一文件，或并行执行有依赖的 plan task（plan 执行仍走 workflow-execute 顺序路径）。

Use when 用户调用 /workflow-execute, or 已有 workflow 需要继续推进任务, or 用户说「继续/接着跑/继续执行/下一个 task/resume workflow/把剩下的任务跑完」要恢复已有 workflow 执行。

Proactively use when Claude Code is stuck, wants a second implementation or diagnosis pass, needs a deeper root-cause investigation, or should hand a substantial coding task to Codex through the native App Server runtime. Supports multi-turn sessions via --session-id.

Use when /workflow-spec 已审批通过, or 用户调用 /workflow-plan 在已审批 Spec 基础上扩写实施计划, or 用户说"扩写实施计划 / 详细 task 拆分"且已有审批过的 spec。

当用户给出 alidocs.dingtalk.com 链接、钉钉文档/钉钉表格/钉钉 AI 表格链接，或要求”根据钉钉表格/文档内容读取数据、更新代码、生成文档、同步权限路由/路由 map”时必须使用本 skill。典型链接包括 https://alidocs.dingtalk.com/i/nodes/...、nodeId、dentryUuid、sheetId、A1:D10。不要用 WebFetch 读取 alidocs；先运行 doctor 检查本地 mcp-gw 配置，已配置则直接通过 CLI 读取。若是 alidocs 节点链接，先用 doc get_document_info 判断类型：extension=axls 走 sheet get_all_sheets/get_range，extension=adoc 走 doc get_document_content/list_document_blocks；仅当缺少对应 doc/sheet/aitable server URL 时再向用户索要 https://mcp-gw.dingtalk.com/server/<hash>?key=<key>。触发词：alidocs、dingtalk-mcp、钉钉链接、钉钉在线表格、钉钉电子表格、钉钉文档、钉钉 AI 表格、多维表、权限路由表、路由map、A1 单元格、nodeId、sheetId、mcp-gw。用户明确提到 dws / dws CLI / 钉钉 workspace CLI 时不用本 skill。

API smoke validation for backend contracts from user curl/HAR/.http, OpenAPI/Swagger/Apifox/Postman exports, YApi autogen, workflow spec, backend routes, and frontend call sites; supports quick live curl probes and suite script generation. Use when 用户说「接口冒烟」「生成接口测试脚本」「联调前验接口」「api smoke」「验一下后端」「验一下」「通不通」「可重复跑」「回归」, or 前端想在 UI 成型前先验后端 contract。登录态由用户 cookie 注入,skill 不做登录。

Use when user says 'diagnose this' / 'debug this' / '怎么定位' / 'reproduce 不出来', or reports a bug that throws/fails, or describes a perf regression. 产出根因 + 推荐修复方案,不直接写修复代码。

Use when 用户提供 Figma URL 但只是要读取/查看/提取设计数据而不写代码; or 说「读取设计稿」「看下设计」「提取 token」「导出资源」「设计稿结构」「节点分析」; or 被 figma-ui 委托执行 Phase A 数据获取。当无法判断用户是否需要代码实现时,默认先触发本 skill 完成数据获取。不要在用户明确要求实现/还原/写代码时使用——那属于 figma-ui。

Use when 用户提供 Figma URL 并有明确的代码实现意图（实现/还原/构建/写/改/调/做/convert/implement/restore/build/match/create code）; or 引用现有文件说「按设计稿还原/调整/检查还原度」「和设计不一致」; or 要求换 icon/资源为设计稿里的。仅提供 URL 而无实现动作词（读取/查看/提取/导出/分析）时不触发,走 figma-data。Figma 画布操作(create/edit/delete nodes)走 figma-use。

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions 'grill me' / 「帮我理清」「先别写」「我想想怎么做」「需求不清楚」。

Compact the current conversation into a handoff document for another agent or session to continue. Use when user says 'handoff' / '交接' / '总结给下一个' / 'wrap up for next session' / 'session summary', or context is about to be lost and work needs continuation.

Build throwaway prototypes to flush out design questions before committing. Routes between Logic (terminal TUI for state/data validation) and UI (multiple radically different variants on one route). Use when user says 'prototype this' / '原型' / '试一下' / 'let me play with it' / 'try a few designs' / '验证一下这个设计', or needs to answer a question only running code can answer.

Use when 用户说「先搜一下」「有没有现成库 / 工具 / MCP」「查一下 X 最佳实践」「技术选型」「调研 X」「先搜后写」「deep research」, or 在动手实现前需要把能复用的方案找出来,or 做技术决策前需要拉齐外部证据。

Use when 用户调用 /scan, or 首次使用 workflow 前需要初始化项目配置, or 项目架构 delta 后需要更新 project-config.json / repo-context.md。

Use when 用户调用 /spec-review, or 需要检查 .claude/code-specs/ 库内容是否过期、冲突或模板漂移。

Test-driven development with a red-green-refactor loop, built one vertical slice at a time. Use when user wants to build features or fix bugs with TDD, mentions 'red-green-refactor' / '测试驱动' / 'TDD' / '先写测试', or asks for integration tests. Refuses horizontal slicing (write all tests first then all code) as an anti-pattern.

Stateful multi-session teaching: 把当前目录当作 teaching workspace（MISSION / GLOSSARY / RESOURCES / learning-records），按 Knowledge-Skills-Wisdom 三要素 + zone of proximal development 教用户一门技能或概念。Use when 用户说「教我 X」「我想系统学 X」「teach me」「继续上次的学习」, or 在已有 teaching workspace 目录中继续学习。一次性技术答疑不触发——直接回答即可。

Use when 用户调用 /workflow-delta, or 已有 workflow 出现需求/PRD/API 变化需要影响分析与并入。

Use when 用户调用 /workflow-status, or 需要查看当前 workflow 的状态/进度/下一步建议。只读操作,不修改任何文件。

Use when user wants to create / write / draft / build a new skill — phrases like '写个 skill / 新建 skill / add a skill / 包装成 skill', or reviewing existing SKILL.md for size / description / structural compliance.

路由地图——不知道用哪个 skill 时看这里。Use when 用户说「有哪些命令 / 从哪开始 / workflow 怎么走 / 不知道用哪个 / help / ask workflow」, or 新人上手想了解 skill 体系全貌。只画地图不干活,看完后用对应 /skill 继续。

Find architectural deepening opportunities — refactors that turn shallow modules into deep ones. Uses deletion test, dependency classification, and parallel interface design exploration. Use when user says 'improve architecture' / '架构优化' / 'refactor for testability' / '这块太散了' / 'find deepening opportunities', or wants to consolidate tightly-coupled shallow modules.

Resolve git merge conflicts hunk-by-hunk. Use when git reports merge conflicts (merge / rebase / cherry-pick 中出现 CONFLICT), or user says '解决冲突' / 'merge conflict' / '合并冲突' / 'rebase 卡住了' / 'cherry-pick 冲突'. 保留双方意图,不发明新行为,永不 --abort。

Use when 用户调用 /workflow-archive, or workflow 状态为 completed 需要 archive。