6993677ed9
- Introduced command-relationships.json to define relationships between various commands. - Created essential-commands.json to provide detailed descriptions and usage scenarios for key commands. - Implemented update-index.sh script for maintaining command index files, including backup and validation processes. - Added templates for bug reports, feature requests, and questions to streamline issue reporting and feature suggestions.
5.5 KiB
name, description, allowed-tools
| name | description | allowed-tools |
|---|---|---|
| command-guide | Workflow command guide for Claude DMS3 (69 commands). Search/browse commands, get next-step recommendations, view documentation, report issues. Triggers "CCW-help", "CCW-issue", "how to use", "search commands", "what's next", beginner onboarding questions | Read, Grep, Glob, AskUserQuestion |
Command Guide Skill
Comprehensive command guide for Claude DMS3 workflow system covering 69 commands across 4 categories (workflow, cli, memory, task).
🎯 Operation Modes
Mode 1: Command Search 🔍
When: User searches by keyword, category, or use-case
Triggers: "搜索命令", "find command", "planning 相关", "search"
Process:
- Identify search type (keyword/category/use-case)
- Query appropriate index (all-commands/by-category/by-use-case)
- Return matching commands with metadata
- Suggest related commands
Example: "搜索 planning 命令" → Lists planning commands from index/by-use-case.json
Mode 2: Smart Recommendations 🤖
When: User asks for next steps after a command
Triggers: "下一步", "what's next", "after /workflow:plan", "推荐"
Process:
- Parse current context (last command/workflow state)
- Query
index/command-relationships.json - Return recommended next commands with rationale
- Show common workflow patterns
Example: "执行完 /workflow:plan 后做什么？" → Recommends /workflow:execute or /workflow:action-plan-verify
Mode 3: Full Documentation 📖
When: User requests command details
Triggers: "参数说明", "怎么用", "how to use", "详情"
Process:
- Locate command in
index/all-commands.json - Read original command file for full details
- Present parameters, arguments, examples
- Link to related commands
Example: "/workflow:plan 的参数是什么？" → Shows full parameter list and usage examples
Mode 4: Beginner Onboarding 🎓
When: New user needs guidance
Triggers: "新手", "getting started", "如何开始", "常用命令"
Process:
- Present progressive learning path
- Show
index/essential-commands.json(Top 14 commands) - Link to getting-started guide
- Provide first workflow example
Example: "我是新手，如何开始？" → Learning path + Top 14 commands + quick start guide
Mode 5: Issue Reporting 📝
When: User wants to report issue or request feature
Triggers: "CCW-issue", "CCW-help", "报告 bug", "功能建议", "问题咨询"
Process:
- Use AskUserQuestion to confirm type (bug/feature/question)
- Collect required information interactively
- Select appropriate template (
templates/issue-{type}.md) - Generate filled template and save/display
Example: "CCW-issue" → Interactive Q&A → Generates GitHub issue template
📚 Index Files
All command metadata is stored in JSON indexes for fast querying:
- all-commands.json - Complete catalog (69 commands) with full metadata
- by-category.json - Hierarchical organization (workflow/cli/memory/task)
- by-use-case.json - Grouped by scenario (planning/implementation/testing/docs/session)
- essential-commands.json - Top 14 most-used commands
- command-relationships.json - Next-step recommendations and dependencies
📖 Detailed structure: Index Structure Reference
🗂️ Supporting Guides
- Getting Started - 5-minute quickstart for beginners
- Workflow Patterns - Common workflow examples (Plan→Execute, TDD, UI design)
- CLI Tools Guide - Gemini/Qwen/Codex usage
- Troubleshooting - Common issues and solutions
- Implementation Details - Detailed logic for each mode
- Usage Examples - Example dialogues and edge cases
🛠️ Issue Templates
Generate standardized GitHub issue templates:
- Bug Report - Report command errors or system bugs
- Feature Request - Suggest new features or improvements
- Question - Ask usage questions or request help
Templates are auto-populated during Mode 5 (Issue Reporting) interaction.
📊 System Statistics
- Total Commands: 69
- Categories: 4 (workflow: 46, cli: 9, memory: 8, task: 4, general: 2)
- Use Cases: 5 (planning, implementation, testing, documentation, session-management)
- Difficulty Levels: 3 (Beginner, Intermediate, Advanced)
- Essential Commands: 14
🔧 Maintenance
Updating Indexes
When commands are added/modified/removed:
bash scripts/update-index.sh
This script:
- Scans all command files in
../../commands/ - Extracts metadata from YAML frontmatter
- Analyzes command relationships
- Regenerates all 5 index files
Committing Updates
git add .claude/skills/command-guide/index/
git commit -m "docs: update command indexes"
git push
Team members get latest indexes via git pull.
📖 Related Documentation
- Workflow Architecture - System design overview
- Intelligent Tools Strategy - CLI tool selection
- Context Search Strategy - Search patterns
- Task Core - Task system fundamentals
Version: 1.0.0 Last Updated: 2025-01-06 Maintainer: Claude DMS3 Team