Claude-Code-Workflow/.claude/skills/command-guide/guides/examples.md

Usage Examples

Comprehensive examples of command-guide skill in action across all 5 operation modes.

---

Mode 1: Command Search 🔍

Example 1: Keyword Search

User: "搜索包含 'execute' 的命令"

Skill Response:

找到 4 个相关命令：

1. **cli:execute** (高级)
   描述: Auto-execution of implementation tasks with YOLO permissions
   参数: [--agent] [--tool codex|gemini|qwen] [--enhance] description or task-id
   场景: implementation

2. **task:execute** (中级)
   描述: Execute tasks with appropriate agents and context-aware orchestration
   参数: task-id
   场景: implementation

3. **workflow:execute** (中级)
   描述: Coordinate agents for existing workflow tasks with automatic discovery
   参数: [--resume-session="session-id"]
   场景: implementation

4. **codex-execute** (高级)
   描述: Automated task decomposition and execution with Codex
   参数: task description or task-id
   场景: implementation

💡 相关命令: workflow:plan, task:create
📖 详细文档: [Implementation Commands](workflow-patterns.md#implementation)

---

Example 2: Category Search

User: "cli 类别下有哪些命令？"

Skill Response:

CLI 类别包含 9 个命令：

**核心命令** (6个):
- cli:analyze - Quick codebase analysis
- cli:chat - Direct codebase interaction
- cli:execute - Auto-execution with YOLO
- cli:cli-init - Initialize CLI tool configs
- cli:codex-execute - Codex-powered execution
- cli:discuss-plan - Multi-model planning discussion

**模式命令** (3个):
- cli:mode:plan - Project planning mode
- cli:mode:code-analysis - Deep code analysis mode
- cli:mode:bug-diagnosis - Bug diagnosis mode

📚 使用指南: [CLI Tools Guide](cli-tools-guide.md)

---

Example 3: Use-Case Search

User: "planning 相关的命令有哪些？"

Skill Response:

Planning 场景包含 8 个命令：

**核心规划**:
1. workflow:plan (高级) - 5阶段规划工作流
2. cli:mode:plan (高级) - 项目规划和架构分析
3. workflow:tdd-plan (高级) - TDD 规划工作流

**任务分解**:
4. task:breakdown (中级) - 智能任务分解
5. workflow:tools:task-generate (中级) - 生成任务 JSON

**架构设计**:
6. workflow:brainstorm:system-architect (中级) - 系统架构师头脑风暴
7. workflow:brainstorm:api-designer (中级) - API 设计师头脑风暴

**评估验证**:
8. workflow:action-plan-verify (中级) - 规划质量验证

💡 常见工作流: Plan → Verify → Execute
📖 模式参考: [Workflow Patterns](workflow-patterns.md#planning-workflow)

---

Mode 2: Smart Recommendations 🤖

Example 1: After Planning

User: "执行完 /workflow:plan 后下一步做什么？"

Skill Response:

推荐的后续步骤：

**🎯 主要选择**:
1. **/workflow:execute** - 开始执行规划的任务
   ✅ 这是最常见的下一步
   作用: 实际执行 workflow:plan 生成的任务

**📋 可选步骤**:
2. **/workflow:action-plan-verify** - 验证规划质量
   作用: 在执行前检查规划的一致性和完整性
   建议: 重要项目建议先验证

3. **/workflow:status** - 查看规划状态
   作用: 查看生成的任务和当前进度

**📚 完整工作流模式**:
Plan → Verify (可选) → Execute → Review

详见: [Planning Workflow Pattern](workflow-patterns.md#planning-execution)

---

Example 2: After Execution

User: "workflow:execute 执行完成后，推荐做什么？"

Skill Response:

推荐的后续步骤：

**🎯 主要选择**:
1. **/workflow:review** - 审查实现结果
   ✅ 检查代码质量、安全性、架构
   参数: [--type=quality|security|architecture]

**📊 可选步骤**:
2. **/workflow:status** - 查看执行状态
   作用: 确认所有任务都已完成

3. **/workflow:test-gen** - 生成测试
   作用: 为实现的功能创建测试用例

4. **/workflow:session:complete** - 完成会话
   作用: 标记工作流已完成，归档经验

**🔄 如果需要修改**:
- /task:replan - 重新规划某个任务
- /workflow:resume - 恢复工作流

详见: [Execution Review Pattern](workflow-patterns.md#execution-review)

---

Mode 3: Full Documentation 📖

Example 1: Command Parameters

User: "/workflow:plan 的参数是什么？"

Skill Response:

# workflow:plan

**描述**: Orchestrate 5-phase planning workflow with quality gate, executing commands and passing context between phases

**参数**:
```bash
/workflow:plan [--agent] [--cli-execute] "text description"|file.md

参数说明:

• --agent (可选): 使用 agent 模式执行规划
• --cli-execute (可选): 允许在规划阶段执行 CLI 命令
• "text description": 任务描述文本
• file.md: 或者提供任务描述文件路径

使用场景: planning 难度级别: 高级

使用示例:

# 基本用法
/workflow:plan "实现用户认证功能"

# 使用 agent 模式
/workflow:plan --agent "重构支付模块"

# 从文件读取
/workflow:plan --agent feature-spec.md

# 允许 CLI 执行
/workflow:plan --cli-execute "添加搜索功能"

执行流程:

1. 上下文收集
2. 概念规划
3. 实现规划
4. 任务生成
5. 质量验证

相关命令:

• workflow:execute - 执行规划的任务
• workflow:action-plan-verify - 验证规划质量
• workflow:status - 查看规划状态

详细文档: ../../commands/workflow/plan.md

---

## Mode 4: Beginner Onboarding 🎓

### Example 1: Complete Beginner

**User**: "我是新手，如何开始使用工作流系统？"

**Skill Response**:

欢迎使用 Claude DMS3 工作流系统！🎉

🚀 快速开始（3 步）

Step 1: 了解核心命令（Top 5）

1. /workflow:plan - 规划一个功能或任务 用法: /workflow:plan "你想做的事情"

2. /workflow:execute - 执行规划的任务 用法: /workflow:execute

3. /cli:execute - 快速自动执行 用法: /cli:execute "实现XXX功能"

4. /task:create - 创建单个任务 用法: /task:create "任务标题"

5. /enhance-prompt - 优化你的提示词 用法: /enhance-prompt "你的想法"

Step 2: 尝试第一个工作流

# 1. 规划一个简单功能
/workflow:plan "添加用户登录功能"

# 2. 执行规划
/workflow:execute

# 3. 审查结果
/workflow:review

Step 3: 学习资源

📖 必读指南:

• 5分钟快速开始
• 常见工作流模式

🛠️ 工具指南:

• CLI 工具使用
• 问题排查

💡 下一步建议:

1. 阅读 getting-started.md（5分钟）
2. 尝试上面的第一个工作流
3. 探索更多命令: 询问 "常用命令有哪些"

有问题随时问 "CCW-help"！

---

### Example 2: Intermediate User

**User**: "常用命令有哪些？"

**Skill Response**:

核心命令列表（Top 14）

🎯 工作流管理 (5个)

1. workflow:plan - 5阶段规划
2. workflow:execute - 执行任务
3. workflow:review - 审查实现
4. workflow:tdd-plan - TDD 规划
5. workflow:test-gen - 生成测试

🛠️ CLI 工具 (3个)

6. cli:execute - 自动执行
7. cli:mode:plan - 规划模式
8. cli:analyze - 代码分析

📋 任务管理 (3个)

9. task:create - 创建任务
10. task:execute - 执行任务
11. task:breakdown - 分解任务

🔧 实用工具 (2个)

12. enhance-prompt - 提示词增强
13. version - 版本信息

💡 使用频率

• 每天: workflow:plan, workflow:execute, cli:execute
• 经常: task:create, enhance-prompt
• 按需: workflow:review, test-gen, tdd-plan

📚 详细文档: Index Structure

---

## Mode 5: Issue Reporting 📝

### Example 1: Bug Report

**User**: "CCW-issue"

**Skill (Interactive)**:

请选择问题类型：

1. 🐛 Bug 报告
2. ✨ 功能请求
3. ❓ 问题咨询

**User**: "1"

**Skill**:

好的，我将帮您创建 Bug 报告。请回答以下问题：

1. 简要描述问题：

**User**: "/workflow:plan 执行后没有生成任务文件"

**Skill**:

2. 您执行的完整命令是什么？

**User**: "/workflow:plan '添加登录功能'"

**Skill**:

3. 期望的结果是什么？

**User**: "应该在 .workflow/ 目录生成 task.json"

**Skill**:

4. 实际发生了什么？

**User**: "命令执行了但没有生成文件"

**Skill**:

✅ Bug 报告已生成！

文件路径: templates/.generated/bug-2025-01-06-123456.md

--- 报告内容 ---

Bug 报告

问题描述

/workflow:plan 执行后没有生成任务文件

执行的命令

/workflow:plan '添加登录功能'

期望行为

应该在 .workflow/ 目录生成 task.json

实际行为

命令执行了但没有生成文件

环境信息

• 操作系统: Windows
• 报告日期: 2025-01-06
• 相关命令: /workflow:plan

---

下一步操作:

1. 复制以上内容到 GitHub Issues
2. 或使用: gh issue create -F templates/.generated/bug-2025-01-06-123456.md

需要更多帮助？使用 "CCW-help"

---

### Example 2: Feature Request

**User**: "我想提个功能建议"

**Skill (Interactive)**:

请选择问题类型：

1. 🐛 Bug 报告
2. ✨ 功能请求
3. ❓ 问题咨询

**User**: "2"

**Skill**:

好的，功能请求。请描述：

1. 您希望添加什么功能？

**User**: "希望 /workflow:plan 能自动估算任务时间"

**Skill**:

2. 这个功能解决什么问题？

**User**: "帮助更好地规划项目进度和资源分配"

**Skill**:

3. 具体的使用场景是什么？（可选）

**User**: "规划大型项目时，能看到预计完成时间"

**Skill**:

✅ 功能请求已生成！

文件路径: templates/.generated/feature-2025-01-06-123457.md

--- 内容预览 ---

功能请求

功能概述

希望 /workflow:plan 能自动估算任务时间

问题背景

帮助更好地规划项目进度和资源分配

使用场景

规划大型项目时，能看到预计完成时间

优先级

• 高 - 严重影响工作效率
• 中 - 有明显改善但有变通方案
• 低 - 锦上添花

---

可以复制到 GitHub 提交，或使用: gh issue create -F templates/.generated/feature-2025-01-06-123457.md

---

## Edge Cases & Error Handling

### Case 1: No Results Found

**User**: "搜索 xyz 命令"

**Skill**:

❌ 未找到包含 "xyz" 的命令

💡 建议：

1. 尝试更广泛的关键词（如 "plan", "execute", "test"）
2. 按类别浏览：workflow, cli, memory, task
3. 查看所有常用命令：询问 "常用命令"
4. 需要帮助：使用 "CCW-help"

📚 快速参考：All Commands Index

---

### Case 2: Ambiguous Query

**User**: "命令"

**Skill**:

您想了解什么？请选择：

1. 🔍 搜索特定命令
2. 🤖 获取命令推荐
3. 📖 查看命令文档
4. 🎓 新手入门指导
5. 📝 报告问题或建议

或者直接说出具体需求，例如：

• "搜索 planning 命令"
• "执行完 /workflow:plan 下一步做什么"
• "/task:create 怎么用"

---

### Case 3: Multiple Matches

**User**: "execute 命令"

**Skill**:

找到多个相关命令，请选择您需要的：

1. cli:execute - CLI 自动执行（推荐新手）
2. task:execute - 执行单个任务
3. workflow:execute - 执行整个工作流

或者询问：

• "cli:execute 的详细文档"
• "三者有什么区别"
• "我该用哪个"

---

**Last Updated**: 2025-01-06