重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
npx skills add https://github.com/dagster-io/erk --skill erk-planning当用户提及以下内容时加载此技能:
当这些触发器触发且本次会话中已保存过计划时:
在会话暂存中检查 plan-saved-issue.marker:
erk exec marker read --session-id <session-id> plan-saved-issue
如果找到(退出码为 0),则使用标记内容调用 /local:plan-update <issue-number>
如果未找到(退出码为 1),则向用户询问问题编号
Erk 计划是用于跟踪实施计划的 GitHub PR。它们具有两部分结构:
plan-body 元数据块中这种分离方式使得元数据可解析,同时计划内容保持可读性。
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
PR #123: "添加功能 X [erk-plan]"
├── 正文(仅元数据):
│ <!-- erk:metadata-block:plan-header -->
│ created_at: 2025-01-05T12:00:00Z
│ created_by: username
│ plan_comment_id: 456789
│ <!-- /erk:metadata-block:plan-header -->
│
│ ## 命令
│ - `erk implement 123`
│ - `erk pr dispatch 123`
│
└── 评论 #456789(第一条评论,计划内容):
<!-- erk:metadata-block:plan-body -->
<details open><summary>计划</summary>
# 添加功能 X
## 实施步骤
1. 第一步
2. 第二步
</details>
<!-- /erk:metadata-block:plan-body -->
在计划模式中编写计划后:
# 通过斜杠命令(推荐)
/erk:plan-save
# 通过 CLI
erk exec plan-save --format display --session-id="<session-id>"
当需要修改已保存到 GitHub 的计划时:
# 通过斜杠命令
/local:plan-update 123
# 通过 CLI
erk exec plan-update --plan-number 123 --session-id="<session-id>"
何时更新 vs 创建新计划:
| 场景 | 操作 |
|---|---|
| 微小修正(拼写错误、澄清说明) | 更新现有计划 |
| 在探索过程中添加细节 | 更新现有计划 |
| 计划从根本上错误/过时 | 通过 /erk:replan 创建新计划 |
| 重大范围变更 | 创建新计划,关闭旧计划 |
获取现有计划(如果不在本地文件中):
gh pr view 123 --comments --json comments
从第一条评论的 plan-body 块中提取内容。
进入计划模式并进行修改
更新问题:
/local:plan-update 123
可选添加评论解释更改内容:
gh pr comment 123 --body "更新计划:为边缘情况处理添加了步骤 3"
当退出计划模式且存在已链接的问题时(例如来自 .erk/impl-context/<branch>/ref.json),请考虑:
plan-update 命令从以下位置查找计划内容:
--plan-path 标志(显式文件路径)--session-id)~/.claude/plans/ 目录(最新的计划文件)| 命令 | 用途 |
|---|---|
/erk:plan-save | 从当前计划创建新的计划 PR |
/local:plan-update | 更新现有计划 |
/erk:plan-implement | 保存计划并立即实施 |
/erk:replan | 分析并重新创建过时的计划 |
erk implement <issue> | 实施已保存的计划 |
workflow.md - 包含示例的完整更新工作流程每周安装数
53
仓库
GitHub 星标数
74
首次出现时间
2026年1月29日
安全审计
安装于
github-copilot53
codex53
opencode52
claude-code52
kimi-cli52
gemini-cli52
Load this skill when user mentions:
When these triggers fire and a plan was saved in this session:
Check for plan-saved-issue.marker in session scratch:
erk exec marker read --session-id <session-id> plan-saved-issue
If found (exit code 0), invoke /local:plan-update <issue-number> with the marker content
If not found (exit code 1), ask user for issue number
Erk-plans are GitHub PRs that track implementation plans. They have a two-part structure:
plan-body metadata blockThis separation keeps metadata parseable while plan content remains readable.
PR #123: "Add feature X [erk-plan]"
├── Body (metadata only):
│ <!-- erk:metadata-block:plan-header -->
│ created_at: 2025-01-05T12:00:00Z
│ created_by: username
│ plan_comment_id: 456789
│ <!-- /erk:metadata-block:plan-header -->
│
│ ## Commands
│ - `erk implement 123`
│ - `erk pr dispatch 123`
│
└── Comment #456789 (first comment, plan content):
<!-- erk:metadata-block:plan-body -->
<details open><summary>Plan</summary>
# Add feature X
## Implementation Steps
1. Step one
2. Step two
</details>
<!-- /erk:metadata-block:plan-body -->
After writing a plan in plan mode:
# Via slash command (recommended)
/erk:plan-save
# Via CLI
erk exec plan-save --format display --session-id="<session-id>"
When you need to modify a plan that's already saved to GitHub:
# Via slash command
/local:plan-update 123
# Via CLI
erk exec plan-update --plan-number 123 --session-id="<session-id>"
When to update vs create new:
| Scenario | Action |
|---|---|
| Minor corrections (typos, clarifications) | Update existing |
| Adding details discovered during exploration | Update existing |
| Plan is fundamentally wrong/obsolete | Create new via /erk:replan |
| Significant scope change | Create new, close old |
Fetch existing plan (if not in local files):
gh pr view 123 --comments --json comments
Extract content from plan-body block in first comment.
Enter plan mode and make modifications
Update the issue :
/local:plan-update 123
Optionally add a comment explaining what changed:
gh pr comment 123 --body "Updated plan: added step 3 for edge case handling"
When exiting plan mode with an existing linked issue (e.g., from .erk/impl-context/<branch>/ref.json), consider:
The plan-update command finds plan content from:
--plan-path flag (explicit file path)--session-id)~/.claude/plans/ directory (latest plan file)| Command | Purpose |
|---|---|
/erk:plan-save | Create new plan PR from current plan |
/local:plan-update | Update existing plan |
/erk:plan-implement | Save plan and immediately implement |
/erk:replan | Analyze and recreate obsolete plan |
erk implement <issue> | Implement a saved plan |
workflow.md - Complete update workflow with examplesWeekly Installs
53
Repository
GitHub Stars
74
First Seen
Jan 29, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
github-copilot53
codex53
opencode52
claude-code52
kimi-cli52
gemini-cli52
Azure Data Explorer (Kusto) 查询技能:KQL数据分析、日志遥测与时间序列处理
152,400 周安装