[ PROMPT_NODE_24560 ]
Command Creator 设计模式
[ SKILL_DOCUMENTATION ]
# 命令模式
本文档描述了斜杠命令的常见模式,帮助您为工作流选择正确的结构。
## 模式类别
### 1. 工作流自动化模式
**结构:** 分析 → 执行 → 报告
**何时使用:**
- 具有清晰顺序的多步骤工作流
- 需要在执行前进行分析的命令
- 产生特定输出(提交、PR、报告)的工作流
**示例工作流:**
1. 检查上下文文件(例如 `.PLAN.md`)
2. 分析当前状态(git 状态、文件更改)
3. 执行操作(创建提交、提交 PR)
4. 向用户报告结果
**关键特性:**
- 明确的文件检查顺序
- 基于文件存在性的条件逻辑
- 清晰的成功输出格式
- 上下文感知的决策制定
**模式示例:**
markdown
1. 检查仓库根目录中的 .PLAN.md
- 如果存在:使用计划上下文作为提交信息
- 如果不存在:分析 git 更改并起草信息
2. 审查 git 状态和差异
- 识别已暂存和未暂存的更改
- 确定更改范围
3. 创建带有描述性信息的提交
- 遵循仓库的提交信息风格
- 包含共同作者署名
4. 使用 Graphite 提交 PR
- 使用 gt stack submit
- 向用户报告 PR URL
### 2. 迭代修复模式
**结构:** 运行 → 解析 → 修复 → 重复
**何时使用:**
- 迭代修复问题的命令(linting、测试、CI)
- 需要多次尝试才能成功的工作流
- 具有明确通过/失败标准的任务
**示例工作流:**
1. 运行检查命令(例如 `make all-ci`)
2. 按类型解析失败
3. 应用针对性修复
4. 再次运行检查以验证
5. 重复直到成功或达到最大迭代次数
**关键特性:**
- 迭代控制(最大尝试次数、卡住检测)
- 使用 TodoWrite 进行进度跟踪
- 清晰的停止条件
- 失败类型的分类
- 增量修复应用
**模式示例:**
markdown
1. 运行 make all-ci(最多 10 次迭代)
2. 如果检查失败:
- 按类别解析错误输出(pyright, ruff, tests)
- 为每个错误类别创建待办事项
- 依次应用每个类别的修复
- 修复每个类别后将待办事项标记为完成
3. 每次修复迭代后:
- 再次运行 make all-ci
- 检查是否出现新错误
- 如果卡住(相同的错误出现 2 次以上):停止并报告
4. 停止条件:
- 所有检查通过(退出代码 0)
- 达到最大迭代次数
- 检测到卡住状态
### 3. 智能体委派模式
**结构:** 上下文 →