[ PROMPT_NODE_24558 ]
Command Creator 使用示例
[ SKILL_DOCUMENTATION ]
# 命令示例
本文档提供了来自 erk 项目的完整、真实的斜杠命令示例。在创建新命令时,请将这些作为参考。
## 示例 1:submit-stack (工作流自动化模式)
**模式:** 工作流自动化(分析 → 执行 → 报告)
**完整源码:**
markdown
---
description: 创建 git 提交并使用 Graphite 提交堆栈
argument-hint:
---
# 提交堆栈
自动创建一个带有有用摘要信息的 git 提交,并将整个 Graphite 堆栈作为拉取请求提交。
## 此命令的功能
1. **分析更改**:首先检查 .PLAN.md 文件以了解上下文,否则查看 git 状态和差异
2. **创建提交**:生成简洁的单句提交信息以总结更改
3. **重堆栈**:运行 `gt restack` 以确保堆栈中的所有分支都已正确变基
4. **提交堆栈**:运行 `gt submit --stack --publish --no-edit` 为整个堆栈创建/更新 PR
5. **报告结果**:显示已提交的 PR 及其 URL
## 用法
bash
# 带描述参数
/submit-stack "Add user authentication feature"
# 不带参数(将自动分析更改)
/submit-stack
## 实现步骤
当调用此命令时:
### 1. 分析当前更改
**首先**:检查仓库根目录中是否存在 `.PLAN.md`:
bash
if [ -f .PLAN.md ]; then
# 使用 .PLAN.md 作为上下文
else
# 回退到 git 分析
fi
如果 `.PLAN.md` 存在:
- 读取计划文件以了解已实现的内容
- 使用计划的摘要和目标来创建提交信息
如果没有 `.PLAN.md`:
- 运行 `git status` 和 `git diff HEAD` 以查看更改
- 审查更改以创建准确的摘要
### 2. 创建 Git 提交
基于分析:
- 如果用户提供了参数,将其用作提交信息的基础
- 如果 `.PLAN.md` 存在,总结计划中实现的内容
- 否则,分析 git 更改并创建描述性的单句摘要
- 确保提交信息遵循仓库的提交风格(检查 `git log` 以获取模式)
- **不要包含任何 Claude Code 页脚或共同作者署名**
bash
git add .
git commit -m "[所做工作的单句总结]"
### 3. 重堆栈
确保堆栈中的所有分支都已正确变基:
bash
gt restack
### 4. 提交堆栈
在没有交互式提示的情况下提交堆栈中的所有 PR:
ba