catlog22/Claude-Code-Workflow
1
0
Fork 0
mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-03-02 15:23:19 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
da19a6ec89a2be6b0e619d873d0fe20e559844cc
Claude-Code-Workflow/docs/zh/guide/ch04-workflow-basics.md
catlog22 65763c76e9 Add TDD Structure Validation and Verification Phases with Comprehensive Reporting 
- Introduced Phase 6: TDD Structure Validation to ensure compliance with TDD workflow standards, including task structure validation, dependency checks, and user configuration verification.
- Implemented Phase 7: TDD Verification for full compliance checks, including task chain structure validation, coverage analysis, and TDD cycle verification.
- Generated detailed TDD compliance reports with quality gate recommendations based on objective criteria.
- Added documentation for new commands and workflows in the Claude Commands index.
2026-02-28 20:41:06 +08:00

8.0 KiB
Raw Blame History

工作流基础

一句话定位

工作流是团队协作的核心 — 8 种工作流覆盖开发全流程，从规划到执行，从分析到测试。

4.1 工作流概览

工作流 核心命令 适用场景 角色
PlanEx /workflow-plan 新功能开发、需求实现 planner, executor
IterDev /refactor-cycle 代码重构、技术债处理 developer, reviewer
Lifecycle /unified-execute-with-file 完整开发周期 analyzer, developer, tester, reviewer
Issue /issue:* Issue 驱动开发 discoverer, planner, executor
Testing /integration-test-cycle 集成测试、测试生成 tester, developer
QA /review-cycle 代码审查和质量保证 qa, developer
Brainstorm /brainstorm-with-file 多视角分析、技术决策 facilitator, perspectives
UIDesign /workflow:ui-design UI 设计和代码生成 designer, developer

4.2 PlanEx - 规划执行工作流

4.2.1 一句话定位

PlanEx 是规划与执行分离的工作流 — 先规划再执行，确保任务清晰后再动手。

4.2.2 启动方式

/workflow-plan

或直接描述需求：

实现用户登录功能，支持邮箱和手机号登录

4.2.3 工作流程

graph LR
    A[Planner<br/>规划阶段] -->|plan_ready| B[Executor<br/>执行阶段]
    B -->|task_complete| C[Reviewer<br/>审查阶段]

    A --> A1[需求分析<br/>任务分解<br/>计划生成]
    B --> B1[任务执行<br/>代码生成<br/>测试编写]
    C --> C1[代码审查<br/>质量检查<br/>反馈修复]

4.2.4 输出产物

产物 位置 说明
需求分析 artifacts/requirements.md 需求详细分析
任务计划 artifacts/plan.md 结构化任务列表
执行产物 artifacts/implementation/ 代码和测试
智慧积累 wisdom/learnings.md 过程中学到的经验

4.3 IterDev - 迭代开发工作流

4.3.1 一句话定位

IterDev 是迭代重构工作流 — 发现技术债、规划重构、迭代改进。

4.3.2 启动方式

/refactor-cycle

4.3.3 工作流程

graph LR
    A[Discover<br/>发现阶段] -->|discoveries| B[Plan<br/>规划阶段]
    B -->|plan| C[Refactor<br/>重构阶段]

    A --> A1[代码分析<br/>问题识别<br/>技术债记录]
    B --> B1[重构策略<br/>优先级排序<br/>任务分解]
    C --> C1[代码修改<br/>测试验证<br/>文档更新]

4.3.4 使用场景

场景 示例
代码异味 函数过长、重复代码
架构改进 解耦合、模块化
性能优化 算法优化、缓存策略
安全加固 修复安全漏洞
规范统一 代码风格统一

4.4 Lifecycle - 生命周期工作流

4.4.1 一句话定位

Lifecycle 是全生命周期覆盖工作流 — 从分析到测试到审查，完整闭环。

4.4.2 启动方式

/unified-execute-with-file <file>

4.4.3 角色职责

角色 职责 输出
Analyzer 分析需求、探索代码 分析报告
Developer 实现功能、编写测试 代码 + 测试
Tester 运行测试、验证功能 测试报告
Reviewer 代码审查、质量检查 审查报告

4.4.4 工作流程

graph LR
    A[Analyzer<br/>分析] --> B[Developer<br/>开发]
    B --> C[Tester<br/>测试]
    C --> D[Reviewer<br/>审查]

    A --> A1[需求分析<br/>代码探索]
    B --> B1[代码实现<br/>单元测试]
    C --> C1[测试验证<br/>回归测试]
    D --> D1[质量把关<br/>最终确认]

4.5 Issue - Issue 管理工作流

4.5.1 一句话定位

Issue 是 Issue 驱动开发工作流 — 从 Issue 发现到规划到执行，完整追踪。

4.5.2 Issue 命令

命令 功能 示例
discover 发现 Issue /issue discover https://github.com/xxx/issue/1
discover-by-prompt 从 Prompt 创建 /issue discover-by-prompt "登录失败"
from-brainstorm 从头脑风暴创建 /issue from-brainstorm
plan 批量规划 Issue /issue plan
queue 形成执行队列 /issue queue
execute 执行 Issue 队列 /issue execute

4.5.3 工作流程

graph LR
    A[Discover<br/>发现] -->|issues| B[Plan<br/>规划]
    B -->|plan| C[Queue<br/>排队]
    C -->|queue| D[Execute<br/>执行]

    A --> A1[识别问题<br/>定义范围]
    B --> B1[分析需求<br/>制定计划]
    C --> C1[优先级排序<br/>依赖关系]
    D --> D1[实现方案<br/>验证结果]

4.6 Testing - 测试工作流

4.6.1 一句话定位

Testing 是自迭代测试工作流 — 自动生成测试、迭代改进测试覆盖率。

4.6.2 启动方式

/integration-test-cycle

4.6.3 工作流程

graph LR
    A[Generate<br/>生成] --> B[Execute<br/>执行]
    B --> C[Verify<br/>验证]

    A --> A1[测试用例<br/>Mock 数据]
    B --> B1[运行测试<br/>失败分析]
    C --> C1[覆盖率分析<br/>缺口补充]

4.7 QA - 质量保证工作流

4.7.1 一句话定位

QA 是代码审查工作流 — 6 维度代码审查，自动发现问题。

4.7.2 启动方式

/review-cycle

4.7.3 审查维度

维度 检查项
正确性 逻辑正确、边界处理
性能 算法效率、资源使用
安全 注入漏洞、权限检查
可维护性 代码清晰、模块化
测试覆盖 单元测试、边界测试
规范符合 编码规范、项目约定

4.8 Brainstorm - 头脑风暴工作流

4.8.1 一句话定位

Brainstorm 是多视角分析工作流 — 从多个视角分析问题，获得全面洞察。

4.8.2 启动方式

/brainstorm-with-file <file>

4.8.3 分析视角

视角 角色 聚焦
Product 产品经理 市场契合、用户价值
Technical 技术负责人 可行性、技术债
Quality QA 负责人 完整性、可测试性
Risk 风险分析师 风险识别、依赖关系

4.8.4 输出格式

## 一致结论
- [共识点 1]
- [共识点 2]

## 分歧点
- [分歧 1]
  - 视角 A: ...
  - 视角 B: ...
  - 建议: ...

## 行动项
- [ ] [行动项 1]
- [ ] [行动项 2]

4.9 UIDesign - UI 设计工作流

4.9.1 一句话定位

UIDesign 是 UI 设计生成工作流 — 从设计稿到代码，自动提取样式和布局。

4.9.2 UI 设计命令

命令 功能
generate 生成 UI 组件
import-from-code 从代码导入样式
style-extract 提取样式规范
layout-extract 提取布局结构
imitate-auto 模仿参考页面
codify-style 样式代码化
design-sync 同步设计变更

4.10 快速参考

工作流选择指南

需求 推荐工作流 命令
新功能开发 PlanEx /workflow-plan
代码重构 IterDev /refactor-cycle
完整开发 Lifecycle /unified-execute-with-file
Issue 管理 Issue /issue:*
测试生成 Testing /integration-test-cycle
代码审查 QA /review-cycle
多视角分析 Brainstorm /brainstorm-with-file
UI 开发 UIDesign /workflow:ui-design

会话管理命令

命令 功能
/workflow:session:start 启动新会话
/workflow:session:resume 恢复会话
/workflow:session:list 列出会话
/workflow:session:complete 完成会话
/workflow:session:solidify 固化成果

下一步

Reference in New Issue View Git Blame Copy Permalink