ccw-help

CCW-Help Skill

CCW command help system, providing command search, recommendation, and documentation viewing features.

Trigger Conditions

• Keywords: "ccw-help", "ccw-issue", "help", "command", "how to use"
• Scenario: asking about command usage, searching commands, requesting next-step suggestions

Operation Modes

Mode 1: Command Search

Triggers: "search commands", "find command", "search"

Process:

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

Mode 2: Smart Recommendations

Triggers: "next step", "what's next", "recommendation"

Process:

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

Mode 3: Documentation

Triggers: "how to use", "how to use", "details"

Process:

1. Locate command in command.json
2. Read source file via source path
3. Provide context-specific examples

Mode 4: Beginner Onboarding

Triggers: "beginner", "getting started", "common commands"

Process:

1. Query essential_commands array
2. Guide appropriate workflow entry point

Mode 5: Issue Reporting

Triggers: "ccw-issue", "report bug"

Process:

1. Use AskUserQuestion to gather context
2. Generate structured issue template

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

Source Path Format

source The field is a relative path (from skills/ccw-help/ directory):

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

Slash Commands

/ccw-help                    # 通用帮助入口
/ccw-help search <keyword>   # 搜索命令
/ccw-help next <command>     # 获取下一步建议
/ccw-issue                   # 问题报告

Maintenance

Update Index

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

Script function: scans the commands/ and agents/ directories, generates a unified command.json

Statistics

• Commands: 88+
• Agents: 16
• Essential: 10 core commands

Core Principle

Intelligent integration, not template copying

• Understand the user's specific situation
• Integrate information from multiple sources
• Customize examples and explanations