958567e35a
版本更新: v5.4.0 → v5.5.0 核心改进: - ✨ 命令指南技能 - 支持 CCW-help 和 CCW-issue 关键词触发 - ✨ 增强命令描述 - 所有 69 个命令更新了详细功能说明 - ✨ 5 索引命令系统 - 按分类、使用场景、关系和核心命令组织 - ✨ 智能推荐 - 基于上下文的下一步操作建议 文档更新: - README.md / README_CN.md: 新增"需要帮助？"章节，介绍 CCW-help/CCW-issue 用法 - CHANGELOG.md: 添加完整的 v5.5.0 版本说明（109行详细内容） - SKILL.md: 更新版本至 v1.1.0 命令指南功能: - 🔍 智能命令搜索 - 按关键词、分类或场景查找 - 🤖 下一步推荐 - 工作流引导和上下文建议 - 📖 详细文档 - 参数、示例和最佳实践 - 🎓 新手入门 - 14 个核心命令学习路径 - 📝 问题报告 - 标准化 bug 报告和功能请求模板 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
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.1.0 Last Updated: 2025-11-06 Maintainer: Claude DMS3 Team