ccw-help

CCW-Help 技能

CCW 命令帮助系统，提供命令搜索、推荐、文档查看、Skill/Team 浏览功能。

触发条件

• 关键词：“ccw-help”“ccw-issue”“帮助”“命令”“怎么用”“ccw 怎么用”“工作流”“skill”“team”
• 场景：询问命令用法、搜索命令、请求下一步建议、询问任务应该使用哪个工作流、浏览 Skill/Team 目录

操作模式

模式 1：命令搜索

触发词：“搜索命令”“find command”“search”

流程：

1. 查询 command.json 的 commands 数组
2. 按名称、描述、类别筛选
3. 展示最相关的 3-5 个命令

模式 2：智能推荐

触发词：“下一步”“what's next”“推荐”

流程：

1. 查询 command.json 中命令的 flow.next_steps
2. 解释每条推荐为何适用

模式 3：文档

触发词：“怎么用”“how to use”“详情”

流程：

1. 在 command.json 中查找命令
2. 通过 source 路径读取源文件
3. 提供适合具体情境的示例

模式 4：新手入门

触发词：“新手”“getting started”“常用命令”

流程：

1. 查询 essential_commands 数组
2. 指引用户选择合适的工作流入口

模式 5：CCW 命令编排

触发词：“ccw ”“自动工作流”“自动选择工作流”“帮我规划”

流程：

1. 分析用户意图（任务类型、复杂度、清晰度）
2. 自动选择工作流级别（1-4 或 Issue）
3. 根据工作流构建命令链
4. 获取用户确认
5. 执行命令链并跟踪 TODO

支持的工作流（参考 ccw.md）：

• 级别 1（Lite-Lite-Lite）：极简单的快速任务
• 级别 2（Rapid/Hotfix）：Bug 修复、简单功能、文档
• 级别 2.5（Rapid-to-Issue）：从快速规划衔接到 issue 工作流
• 级别 3（Coupled）：包含规划、执行、审查和测试的复杂功能
• 级别 3 变体：
  • TDD 工作流（测试优先开发）
  • 测试修复工作流（调试失败的测试）
  • 审查工作流（代码审查和修复）
  • UI 设计工作流
  • 多 CLI 协作工作流
  • Cycle 工作流（集成测试、重构）
• 级别 4（Full）：包含头脑风暴的探索性任务
• With-File 工作流：通过多 CLI 协作进行文档化探索
  • brainstorm-with-file：多角度构思 → workflow-plan → workflow-execute
  • debug-with-file：基于假设的调试（独立运行）
  • analyze-with-file：协作分析 → workflow-lite-plan
  • collaborative-plan-with-file：多 Agent 规划 → unified-execute
  • roadmap-with-file：战略需求路线图 → team-planex
• Issue 工作流：批量发现、规划、排队和执行 issue
• Team 工作流：通过 team-planex 波次流水线并行执行

模式 6：Issue 报告

触发词：“ccw-issue”“报告 bug”

流程：

1. 使用 AskUserQuestion 收集上下文
2. 生成结构化 issue 模板

模式 7：Skill 和 Team 浏览

触发词：“skill”“team”“技能”“团队”“有哪些 skill”“team 怎么用”

流程：

1. 查询 command.json 的 skills 数组
2. 按类别筛选：workflow / team / review / meta / utility / standalone
3. 按类别展示 Skill 列表及说明
4. 对于 team skill，说明团队架构和使用模式

数据源

唯一可信数据源：command.json

字段	用途
commands[]	包含元数据的扁平命令列表
commands[].flow	关系（next_steps、prerequisites）
agents[]	Agent 目录
skills[]	包含类别的 Skill 目录
skills[].is_team	Skill 是否使用团队架构
essential_commands[]	核心命令列表

源路径格式

source 字段是相对路径（从 skills/ccw-help/ 目录）：

{
  "name": "lite-plan",
  "source": "../../../commands/workflow/lite-plan.md"
}

Skill 目录

工作流技能（核心工作流）

技能	内部流水线	触发词
workflow-lite-plan	explore → plan → confirm → execute	"lite-plan"，快速任务
workflow-plan	session → context → convention → gen → verify	"workflow-plan"，正式规划
workflow-execute	session discovery → task processing → commit	"workflow-execute"，执行
workflow-tdd-plan	6-phase TDD plan → verify	"tdd-plan"，TDD 开发
workflow-test-fix	session → context → analysis → gen → cycle	"test-fix"，测试修复
workflow-multi-cli-plan	ACE context → CLI discussion → plan → execute	"multi-cli"，多 CLI 协作
workflow-skill-designer	用于设计工作流技能的元技能	"skill-designer"

团队技能（团队协作）

团队技能使用 team-worker Agent 架构，由 Coordinator 编排流水线，Workers 是加载了 role-spec 的 team-worker Agent。

技能	用途	架构
team-planex	规划 + 执行 wave 流水线	planner + executor，适合清晰的 issue/roadmap
team-lifecycle	完整生命周期（spec/impl/test）	使用 role-spec 的 team-worker Agent
team-lifecycle-v4	优化版生命周期	优化后的流水线
team-lifecycle-v3	基础版生命周期	所有角色调用统一技能
team-coordinate	通用动态团队协调	运行时动态生成 role-spec
team-coordinate	通用团队协调 v1	动态角色生成
team-brainstorm	团队头脑风暴	多视角分析
team-frontend	前端开发团队	前端专家
team-issue	Issue 解决团队	Issue 解决流水线
team-iterdev	迭代开发团队	迭代开发
team-review	代码扫描 / 漏洞审查	扫描 + 漏洞审查
team-roadmap-dev	Roadmap 驱动开发	需求 → 实现
team-tech-debt	技术债务清理	债务识别 + 清理
team-testing	测试团队	测试规划 + 执行
team-quality-assurance	QA 团队	质量保证流水线
team-uidesign	UI 设计团队	设计系统 + 原型设计
team-ultra-analyze	深度协作分析	深度协作分析
team-executor	轻量执行（恢复会话）	恢复现有会话
team-executor	轻量执行 v2	改进的会话恢复

独立技能

技能	用途
brainstorm	双模式头脑风暴（自动流水线 / 单角色）
review-code	多维度代码审查
review-cycle	审查 + 自动修复编排
spec-generator	6 阶段规格文档链（product-brief → PRD → architecture → epics）
issue-manage	交互式 Issue 管理（CRUD）
memory-capture	统一记忆捕获（session compact / quick tip）
memory-manage	统一记忆管理（CLAUDE.md + 文档）
command-generator	命令文件生成器
skill-generator	元技能：创建新技能
skill-tuning	技能诊断与优化

工作流映射（CCW 自动路由）

CCW 根据任务意图自动选择工作流级别（参考 ccw.md）：

输入示例	类型	级别	流水线
"Add API endpoint"	feature（低）	2	workflow-lite-plan → workflow-test-fix
"Fix login timeout"	bugfix	2	workflow-lite-plan → workflow-test-fix
"协作分析: 认证架构"	analyze-file	3	analyze-with-file → workflow-lite-plan
"重构 auth 模块"	refactor	3	workflow:refactor-cycle
"multi-cli: API设计"	multi-cli	3	workflow-multi-cli-plan → workflow-test-fix
"头脑风暴: 通知系统"	brainstorm	4	brainstorm-with-file → workflow-plan → workflow-execute
"roadmap: OAuth + 2FA"	roadmap	4	roadmap-with-file → team-planex
"specification: 用户系统"	spec-driven	4	spec-generator → workflow-plan → workflow-execute
"team planex: 用户系统"	team-planex	Team	team-planex

斜杠命令

/ccw "task description"          # Auto-select workflow and execute
/ccw-help                        # General help entry
/ccw-help search <keyword>       # Search commands
/ccw-help next <command>         # Get next step suggestions
/ccw-help skills                 # Browse skill catalog
/ccw-help teams                  # Browse team skills
/ccw-issue                       # Issue reporting

CCW 命令示例

/ccw "Add user authentication"          # → auto-select level 2-3
/ccw "Fix memory leak in WebSocket"     # → auto-select bugfix workflow
/ccw "Implement with TDD"               # → detect TDD, use tdd-plan → execute → tdd-verify
/ccw "头脑风暴: 用户通知系统"          # → detect brainstorm, use brainstorm-with-file
/ccw "深度调试: 系统随机崩溃"          # → detect debug-file, use debug-with-file
/ccw "协作分析: 认证架构设计"          # → detect analyze-file, use analyze-with-file
/ccw "roadmap: OAuth + 2FA 路线图"     # → roadmap-with-file → team-planex
/ccw "集成测试: 支付流程"              # → integration-test-cycle
/ccw "重构 auth 模块"                  # → refactor-cycle

维护

更新机制

CCW-Help 技能支持通过用户确认对话框手动更新。 脚本会扫描 commands/、agents/ 和 skills/ 目录，以重新生成所有索引。

如何更新

选项 1：执行技能时，系统会提示用户：

Would you like to update CCW-Help command index?
- Yes: Run auto-update and regenerate command.json
- No: Use current index

选项 2：手动更新

cd D:/Claude_dms3/.claude/skills/ccw-help
python scripts/auto-update.py

这会运行 analyze_commands.py，扫描 commands/、agents/ 和 skills/ 目录，并重新生成 command.json 和所有索引文件。

更新脚本

• auto-update.py：运行 analyze_commands.py 的简单封装
• analyze_commands.py：扫描目录并生成命令/Agent/技能索引

生成的索引文件

文件	内容
command.json	主索引：命令 + Agent + 技能
index/all-commands.json	扁平化命令列表
index/all-agents.json	Agent 目录
index/all-skills.json	包含元数据的技能目录
index/skills-by-category.json	按类别分组的技能
index/by-category.json	按类别分类的命令
index/by-use-case.json	按使用场景分类的命令
index/essential-commands.json	用于入门的核心命令
index/command-relationships.json	命令流程关系

统计数据

• 命令：50+
• Agent：22
• 技能：36+（7 个工作流、19 个团队技能、10+ 个独立技能/实用工具）
• 工作流：6 个主要级别 + 5 个带文件变体 + 2 个循环变体
• 必备项：10 个核心命令

核心原则

智能整合，非模板复制

• 理解用户的具体情况
• 整合多个来源的信息
• 定制示例和说明