mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-05 01:50:27 +08:00

Files

catlog22 967e3805b7 docs: 标准化命令文档格式，移除表情符号并添加命令模板规范

更新所有命令文档以提高可读性和一致性：
- 移除所有表情符号（⚠️, ✅, ❌, ▸等），使用纯文本替代
- 统一标题格式，改进章节结构
- 简化状态指示器和格式标记
- 添加三个新的命令模板规范文档

新增文档：
- COMMAND_FLOW_STANDARD.md - 标准命令流程规范
- COMMAND_TEMPLATE_EXECUTOR.md - 执行器命令模板
- COMMAND_TEMPLATE_ORCHESTRATOR.md - 编排器命令模板

影响范围：
- CLI命令（cli-init, codex-execute, discuss-plan, execute）
- 内存管理命令（skill-memory, tech-research, workflow-skill-memory）
- 任务管理命令（breakdown, create, execute, replan）
- 工作流命令（所有workflow相关命令）

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-05 21:48:43 +08:00

3.3 KiB

Raw Blame History

Command Template: Orchestrator

用途：协调多个子命令的编排器命令模板

特征：保留 Related Commands 段落，明确说明调用的命令链

模板结构

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

# Command Name (/category:command-name)

## Overview
Clear description of what this command orchestrates and its role.

**Key Characteristics**:
- Orchestrates X phases/commands
- Coordinates between multiple slash commands
- Does NOT execute directly - delegates to specialized commands
- Manages workflow state and progress tracking

## Core Responsibilities
- Responsibility 1: Description
- Responsibility 2: Description
- Responsibility 3: Description

## Execution Flow

### Phase 1: Phase Name
**Command**: `SlashCommand(command="/command:name args")`

**Input**: Description of inputs

**Expected Behavior**:
- Behavior 1
- Behavior 2

**Parse Output**:
- Extract: variable name (pattern description)

**Validation**:
- Validation rule 1
- Validation rule 2

**TodoWrite**: Mark phase 1 completed, phase 2 in_progress

---

### Phase 2: Phase Name
[Repeat structure for each phase]

---

## TodoWrite Pattern

Track progress through all phases:

```javascript
TodoWrite({todos: [
  {"content": "Execute phase 1", "status": "in_progress|completed", "activeForm": "Executing phase 1"},
  {"content": "Execute phase 2", "status": "pending|in_progress|completed", "activeForm": "Executing phase 2"},
  {"content": "Execute phase 3", "status": "pending|in_progress|completed", "activeForm": "Executing phase 3"}
]})

Data Flow

Phase 1: command-1 → output-1
  ↓
Phase 2: command-2 (input: output-1) → output-2
  ↓
Phase 3: command-3 (input: output-2) → final-result

Error Handling

Phase	Error	Action
1	Error description	Recovery action
2	Error description	Recovery action

Usage Examples

Basic Usage

/category:command-name
/category:command-name --flag "argument"

Prerequisite Commands:

/command:prerequisite - Description of when to use before this

Called by This Command:

/command:phase1 - Description (Phase 1)
/command:phase2 - Description (Phase 2)
/command:phase3 - Description (Phase 3)

Follow-up Commands:

/command:next - Description of what to do after this


---

## 使用规则

### 核心原则
1. **保留 Related Commands** - 明确说明命令调用链
2. **清晰的阶段划分** - 每个Phase独立可追踪
3. **数据流可视化** - 展示Phase间的数据传递
4. **TodoWrite追踪** - 实时更新执行进度

### Related Commands 分类
- **Prerequisite Commands**: 执行本命令前需要先运行的命令
- **Called by This Command**: 本命令会调用的子命令（按阶段分组）
- **Follow-up Commands**: 执行本命令后的推荐下一步

### 格式要求
- 无 emoji/图标装饰
- 纯文本状态指示器
- 使用表格组织错误信息
- 清晰的数据流图

## 示例参考

参考已重构的编排器命令：
- `.claude/commands/workflow/plan.md`
- `.claude/commands/workflow/execute.md`
- `.claude/commands/workflow/session/complete.md`
- `.claude/commands/workflow/session/start.md`

3.3 KiB Raw Blame History