Files
Claude-Code-Workflow/docs/zh/skills/index.md
catlog22 0d5cc4a74f refactor(workflow): rename workflow-lite-plan to workflow-lite-planex and remove standalone lite-execute
- Rename skill directory from workflow-lite-plan to workflow-lite-planex (planex = plan + execute)
- Remove standalone lite-execute command entry from command.json and analyze_commands.py
- Update all 60+ files referencing workflow-lite-plan to use workflow-lite-planex
- Update descriptions to clarify Phase 1: plan → Phase 2: execute architecture
- Remove lite-execute as standalone command from orchestrator routing tables
- Update docs (EN/ZH) to reflect unified planex naming and phase descriptions
2026-03-02 14:03:17 +08:00

8.9 KiB
Raw Blame History

Skills 库

完整的 33 个 CCW 内置技能参考手册,涵盖 3 大类别,以及自定义技能开发指南。

什么是 Skills

Skills 是 CCW 可执行的、可复用的、领域特定的能力。每个技能都针对特定的开发任务或工作流而设计,可以组合成强大的工作流链。

类别概览

类别 数量 说明
独立技能 12 用于特定任务的单用途技能
团队技能 14 多代理协作技能
工作流技能 7 规划和执行流水线技能

快速参考

独立技能

技能 触发器 说明
brainstorm brainstorm, 头脑风暴 双模式统一头脑风暴
ccw-help ccw-help, ccw-issue 命令帮助系统
memory-capture memory capture, compact session 会话压缩或快速提示
memory-manage memory manage, update claude, 更新记忆 CLAUDE.md 更新和文档生成
issue-manage manage issue, list issues 交互式问题管理
review-code review code, code review 6 维度代码审查
review-cycle workflow:review-cycle 带自动修复的审查
skill-generator create skill, new skill 创建技能的元技能
skill-tuning skill tuning, tune skill 技能诊断和优化
spec-generator generate spec, create specification, spec generator 6 阶段规范生成
software-manual software manual, user guide 交互式 HTML 文档
command-generator generate command 命令文件生成

团队技能

技能 触发器 角色 说明
team-lifecycle-v4 team lifecycle 8 完整规范/实现/测试生命周期
team-brainstorm team brainstorm 5 多角度创意生成
team-frontend team frontend 6 带 UI/UX 的前端开发
team-issue team issue 6 问题解决流水线
team-iterdev team iterdev 5 生成器-评论者循环
team-planex team planex 3 规划-执行流水线
team-quality-assurance team qa, team quality-assurance 6 QA 测试工作流
team-review team-review 4 代码扫描和修复
team-roadmap-dev team roadmap-dev 4 路线图驱动开发
team-tech-debt tech debt cleanup, 技术债务 6 技术债务识别
team-testing team testing 5 渐进式测试覆盖
team-uidesign team uidesign 4 带 Design Token 的 UI 设计
team-ultra-analyze team ultra-analyze, team analyze 5 深度协作分析

工作流技能

技能 触发器 说明
workflow-plan workflow-plan, workflow-plan-verify, workflow:replan 4 阶段规划带验证
workflow-lite-planex workflow-lite-planex 轻量级规划
workflow-multi-cli-plan workflow-multi-cli-plan, workflow:multi-cli-plan 多 CLI 协作规划
workflow-execute workflow-execute 任务执行协调
workflow-tdd-plan workflow-tdd-plan TDD 红-绿-重构
workflow-test-fix workflow-test-fix, test fix workflow 测试-修复流水线
workflow-skill-designer design workflow skill, create workflow skill 工作流创建元技能

工作流组合

技能可以组合实现强大的工作流。参见 工作流组合 了解 15 种预定义组合。

常用组合

完整生命周期开发

Skill(skill="brainstorm")
Skill(skill="workflow-plan")
Skill(skill="workflow-execute")
Skill(skill="review-cycle")

快速迭代

Skill(skill="workflow-lite-planex")
Skill(skill="workflow-execute")

测试驱动开发

Skill(skill="workflow-tdd-plan", args="--mode tdd-plan")
Skill(skill="workflow-execute")
Skill(skill="workflow-tdd-plan", args="--mode tdd-verify")

使用技能

CLI 接口

# 通过 ccw 命令调用
ccw --help

# 或直接使用触发器
ccw brainstorm
ccw team lifecycle

编程接口

// 基本使用
Skill(skill="brainstorm")

// 带参数
Skill(skill="team-lifecycle-v4", args="Build user authentication")

// 带模式选择
Skill(skill="workflow-plan", args="--mode verify")

自定义技能

为团队特定工作流创建自己的技能:

技能结构

~/.claude/skills/my-skill/
├── SKILL.md          # 技能定义
├── phases/           # 阶段文件(可选)
│   ├── phase-1.md
│   └── phase-2.md
└── templates/        # 输出模板(可选)
    └── output.md

技能模板

---
name: my-custom-skill
description: My custom skill for X
version: 1.0.0
triggers: [trigger1, trigger2]
---

# My Custom Skill

## Description
Detailed description of what this skill does.

## Phases
1. Phase 1: Description
2. Phase 2: Description

## Usage

\`\`\`javascript
Skill(skill="my-custom-skill", args="input")
\`\`\`

最佳实践

  1. 单一职责:每个技能应做好一件事
  2. 清晰触发器:定义可识别的触发短语
  3. 渐进式阶段:将复杂技能分解为阶段
  4. 紧凑恢复:使用 TodoWrite 进行进度跟踪
  5. 文档:包含使用示例和预期输出

实践示例

示例 1功能开发

场景:实现新的用户仪表板功能

# 步骤 1头脑风暴功能
ccw brainstorm
# 按提示定义:
# - 仪表板小部件(统计、图表、最近活动)
# - 布局偏好
# - 数据刷新间隔

# 步骤 2规划实现
ccw workflow-plan "Build user dashboard with configurable widgets"
# 输出IMPL-001.json 包含任务分解

# 步骤 3团队执行
ccw team lifecycle
# 或使用快速迭代:
ccw workflow-lite-planex && ccw workflow-execute

# 步骤 4审查和优化
ccw review-code
# 修复发现的问题

示例 2Bug 调查

场景:调试 API 端点性能问题

# 步骤 1快速分析
ccw cli -p "Analyze /api/users endpoint for N+1 query issues" --tool gemini --mode analysis

# 步骤 2深度调查如需要
ccw workflow:debug-with-file
# 创建假设、植入代码、分析日志

# 步骤 3应用修复
ccw workflow-execute --task "Fix N+1 query in user endpoint"

示例 3代码迁移

场景:从 JavaScript 迁移到 TypeScript

# 步骤 1分析代码库
ccw workflow:refactor-cycle
# 识别技术债务并创建迁移计划

# 步骤 2分阶段执行迁移
ccw team roadmap-dev --epic "ts-migration"
# 渐进式迁移模块并测试

示例 4文档生成

场景:生成 API 文档

# 步骤 1捕获现有模式
ccw memory:capture "API patterns: REST, versioning, error handling"

# 步骤 2生成文档
ccw software-manual --output ./docs/api/

示例 5代码审查流水线

场景:审查 PR 变更

# 全面审查
ccw review-code --focus security,performance

# 或使用循环自动修复
ccw review-cycle --max-iterations 3

最佳效果提示

  1. 从小开始:简单任务使用 workflow-lite-planex
  2. 使用记忆:用 memory:capture 捕获见解供将来参考
  3. 验证计划:执行前始终审查生成的计划
  4. 迭代:使用 review-cycle 持续改进
  5. 检查会话:使用 workflow:session:list 跟踪进度

设计模式

技能使用这些经证明的模式:

模式 示例
编排器 + 工作者 team-lifecycle-v4
生成器-评论者循环 team-iterdev
波浪流水线 team-planex
红-绿-重构 workflow-tdd-plan

::: info 参见