ccw-help

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

CCW-Help Skill

CCW-Help 技能

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

Trigger Conditions

触发条件

关键词: "ccw-help", "ccw-issue", "帮助", "命令", "怎么用", "ccw 怎么用", "工作流"
场景: 询问命令用法、搜索命令、请求下一步建议、询问任务应该用哪个工作流

关键词: "ccw-help", "ccw-issue", "帮助", "命令", "怎么用", "ccw 怎么用", "工作流"
场景: 询问命令用法、搜索命令、请求下一步建议、询问任务应该用哪个工作流

Operation Modes

操作模式

Mode 1: Command Search

模式1：命令搜索

Triggers: "搜索命令", "find command", "search"

Process:

Query
```
command.json
```
commands array
Filter by name, description, category
Present top 3-5 relevant commands

触发词: "搜索命令", "find command", "search"

处理流程:

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

Mode 2: Smart Recommendations

模式2：智能推荐

Triggers: "下一步", "what's next", "推荐"

Process:

Query command's
```
flow.next_steps
```
in
```
command.json
```
Explain WHY each recommendation fits

触发词: "下一步", "what's next", "推荐"

处理流程:

查询
```
command.json
```
中命令的
```
flow.next_steps
```
字段
解释每个推荐的适配原因

Mode 3: Documentation

模式3：文档查看

Triggers: "怎么用", "how to use", "详情"

Process:

Locate command in
```
command.json
```
Read source file via
```
source
```
path
Provide context-specific examples

触发词: "怎么用", "how to use", "详情"

处理流程:

在
```
command.json
```
中定位命令
通过
```
source
```
路径读取源文件
提供上下文相关的示例

Mode 4: Beginner Onboarding

模式4：新手引导

Triggers: "新手", "getting started", "常用命令"

Process:

Query
```
essential_commands
```
array
Guide appropriate workflow entry point

触发词: "新手", "getting started", "常用命令"

处理流程:

查询
```
essential_commands
```
数组
引导至合适的工作流入口

Mode 5: CCW Command Orchestration

模式5：CCW命令编排

Triggers: "ccw ", "自动工作流", "自动选择工作流", "帮我规划"

Process:

Analyze user intent (task type, complexity, clarity)
Auto-select workflow level (1-4 or Issue)
Build command chain based on workflow
Get user confirmation
Execute chain with TODO tracking

Supported Workflows:

Level 1 (Lite-Lite-Lite): Ultra-simple quick tasks
Level 2 (Rapid/Hotfix): Bug fixes, simple features, documentation
Level 2.5 (Rapid-to-Issue): Bridge from quick planning to issue workflow
Level 3 (Coupled): Complex features with planning, execution, review, tests
Level 3 Variants:
- TDD workflows (test-first development)
- Test-fix workflows (debug failing tests)
- Review workflows (code review and fixes)
- UI design workflows
Level 4 (Full): Exploratory tasks with brainstorming
With-File Workflows: Documented exploration with multi-CLI collaboration
- ```
brainstorm-with-file
```
  : Multi-perspective ideation
- ```
debug-with-file
```
  : Hypothesis-driven debugging
- ```
analyze-with-file
```
  : Collaborative analysis
Issue Workflow: Batch issue discovery, planning, queueing, execution

触发词: "ccw ", "自动工作流", "自动选择工作流", "帮我规划"

处理流程:

分析用户意图（任务类型、复杂度、明确程度）
自动选择工作流级别（1-4级或Issue流程）
基于工作流构建命令链
获取用户确认
执行命令链并跟踪待办事项

支持的工作流:

Level 1（极简版）: 超简单快速任务
Level 2（快速修复/热修复）: Bug修复、简单功能开发、文档编写
Level 2.5（快速转Issue）: 从快速规划到Issue流程的过渡
Level 3（复杂耦合）: 包含规划、执行、评审、测试的复杂功能开发
Level 3变体:
- TDD工作流（测试先行开发）
- 测试修复工作流（调试失败的测试）
- 评审工作流（代码评审与修复）
- UI设计工作流
Level 4（完整流程）: 包含头脑风暴的探索性任务
带文件的工作流: 多CLI协作的文档化探索
- ```
brainstorm-with-file
```
  : 多视角头脑风暴
- ```
debug-with-file
```
  : 基于假设的调试
- ```
analyze-with-file
```
  : 协作分析
Issue工作流: 批量问题发现、规划、排队、执行

Mode 6: Issue Reporting

模式6：问题上报

Triggers: "ccw-issue", "报告 bug"

Process:

Use AskUserQuestion to gather context
Generate structured issue template

触发词: "ccw-issue", "报告 bug"

处理流程:

使用AskUserQuestion收集上下文信息
生成结构化的问题模板

Data Source

数据源

Single source of truth: command.json

Field	Purpose
`commands[]`	Flat command list with metadata
`commands[].flow`	Relationships (next_steps, prerequisites)
`commands[].essential`	Essential flag for onboarding
`agents[]`	Agent directory
`essential_commands[]`	Core commands list

唯一可信数据源：command.json

字段	用途
`commands[]`	包含元数据的扁平化命令列表
`commands[].flow`	命令间关系（下一步、前置条件）
`commands[].essential`	新手引导标记
`agents[]`	Agent目录
`essential_commands[]`	核心命令列表

Source Path Format

源路径格式

source

字段是相对路径（从

skills/ccw-help/

目录）：

json

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

source

字段是相对路径（基于

skills/ccw-help/

目录）：

json

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

Slash Commands

斜杠命令

bash

/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-issue                       # Issue reporting

bash

/ccw "task description"          # 自动选择工作流并执行
/ccw-help                        # 通用帮助入口
/ccw-help search <keyword>       # 搜索命令
/ccw-help next <command>         # 获取下一步建议
/ccw-issue                       # 问题上报

CCW Command Examples

CCW命令示例

bash

/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

bash

/ccw "Add user authentication"          # → 自动选择2-3级工作流
/ccw "Fix memory leak in WebSocket"     # → 自动选择Bug修复工作流
/ccw "Implement with TDD"               # → 识别TDD，使用tdd-plan → 执行 → tdd-verify
/ccw "头脑风暴: 用户通知系统"          # → 识别头脑风暴，使用brainstorm-with-file
/ccw "深度调试: 系统随机崩溃"          # → 识别调试场景，使用debug-with-file
/ccw "协作分析: 认证架构设计"          # → 识别协作分析场景，使用analyze-with-file

Maintenance

维护说明

Update Mechanism

更新机制

CCW-Help skill supports manual updates through user confirmation dialog.

CCW-Help技能支持通过用户确认对话框进行手动更新。

How to Update

更新方法

Option 1: When executing the skill, user will be prompted:

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

Option 2: Manual update

bash

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

This runs

analyze_commands.py

to scan commands/ and agents/ directories and regenerate

command.json

选项1：执行技能时，用户将收到提示:

是否要更新CCW-Help命令索引？
- 是：运行自动更新并重新生成command.json
- 否：使用当前索引

选项2：手动更新

bash

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

该命令将运行

analyze_commands.py

扫描commands/和agents/目录并重新生成

command.json

。

Update Scripts

更新脚本

auto-update.py
: Simple wrapper that runs analyze_commands.py
analyze_commands.py
: Scans directories and generates command index

auto-update.py
: 运行analyze_commands.py的简单封装脚本
analyze_commands.py
: 扫描目录并生成命令索引

Statistics

统计信息

Commands: 50+
Agents: 16
Workflows: 6 main levels + 3 with-file variants
Essential: 10 core commands

命令数量: 50+
Agent数量: 16
工作流数量: 6个主级别 + 3个带文件的变体
核心命令: 10个

Core Principle

核心原则

智能整合，非模板复制

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

智能整合，非模板复制

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