Claude-Code-Workflow/COMMAND_TEMPLATE_EXECUTOR.md

Command Template: Executor

用途：直接执行特定功能的执行器命令模板

特征：专注于自身功能实现，移除 Related Commands 段落

---

模板结构

---
name: command-name
description: Brief description of what this command does
argument-hint: "[flags] arguments"
allowed-tools: Read(*), Edit(*), Write(*), Bash(*), TodoWrite(*)
---

# Command Name (/category:command-name)

## Overview
Clear description of what this command does and its purpose.

**Key Characteristics**:
- Executes specific functionality directly
- Does NOT orchestrate other commands
- Focuses on single responsibility
- Returns concrete results

## Core Functionality
- Function 1: Description
- Function 2: Description
- Function 3: Description

## Usage

### Command Syntax
```bash
/category:command-name [FLAGS] <ARGUMENTS>

# Flags
--flag1        Description
--flag2        Description

# Arguments
<arg1>         Description
<arg2>         Description (optional)

Execution Process

Step 1: Step Name

Description of what happens in this step

Operations:

• Operation 1
• Operation 2

Validation:

• Check 1
• Check 2

---

Step 2: Step Name

[Repeat for each step]

---

Input/Output

Input Requirements

• Input 1: Description and format
• Input 2: Description and format

Output Format

Output description and structure

Error Handling

Common Errors

Error	Cause	Resolution
Error message 1	Root cause	How to fix
Error message 2	Root cause	How to fix

Best Practices

1. Practice 1: Description and rationale
2. Practice 2: Description and rationale
3. Practice 3: Description and rationale

---

## 使用规则

### 核心原则
1. **移除 Related Commands** - 执行器不协调其他命令
2. **专注单一职责** - 每个执行器只做一件事
3. **清晰的步骤划分** - 明确执行流程
4. **完整的错误处理** - 列出常见错误和解决方案

### 可选段落
根据命令特性，以下段落可选：
- **Configuration**: 有配置参数时使用
- **Output Files**: 生成文件时使用
- **Exit Codes**: 有明确退出码时使用
- **Environment Variables**: 依赖环境变量时使用

### 格式要求
- 无 emoji/图标装饰
- 纯文本状态指示器
- 使用表格组织错误信息
- 提供实用的示例代码

## 示例参考

参考已重构的执行器命令：
- `.claude/commands/task/create.md`
- `.claude/commands/task/breakdown.md`
- `.claude/commands/task/execute.md`
- `.claude/commands/cli/execute.md`
- `.claude/commands/version.md`