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
8ceae6d6fd17531291a8d432a6ce6b5f6bbd01a9
Claude-Code-Workflow/docs/zh/skills/index.md
catlog22 8ceae6d6fd Add Chinese documentation for custom skills development and reference guide 
- Created a new document for custom skills development (`custom.md`) detailing the structure, creation, implementation, and best practices for developing custom CCW skills.
- Added an index document (`index.md`) summarizing all built-in skills, their categories, and usage examples.
- Introduced a reference guide (`reference.md`) providing a quick reference for all 33 built-in CCW skills, including triggers and purposes.
2026-03-01 13:08:12 +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-plan workflow-lite-plan 轻量级规划
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-plan")
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-plan && ccw workflow-execute

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

示例 2：Bug 调查

场景：调试 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-plan
  2. 使用记忆：用 memory:capture 捕获见解供将来参考
  3. 验证计划：执行前始终审查生成的计划
  4. 迭代：使用 review-cycle 持续改进
  5. 检查会话：使用 workflow:session:list 跟踪进度

设计模式

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

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

::: info 参见

Reference in New Issue View Git Blame Copy Permalink