⚡

目标协调技能Skill objective

这个技能用于管理需要多个计划或PR来完成的软件开发目标，提供协调文档创建、进度跟踪、教训记录和团队协作功能。关键词：多计划协调、目标管理、软件开发、项目管理、进度跟踪、教训学习、团队协作。

项目管理 0 次安装 0 次浏览 更新于 3/18/2026

name: 目标 description: > 这个技能应用于管理目标——这些是需要2个或更多计划/PR来完成的连贯目标。使用当用户想要创建多计划跟踪问题、记录相关PR的进度、捕获教训或协调跨越多个erk计划的工作时。目标是人类优先的协调文档，不是可执行计划。

目标技能

概述

目标是用于需要多个计划/PR来完成的目标的协调文档。不同于erk计划（单一可执行实现），目标跟踪相关工作的进度并捕获沿途的教训。

范围范围:

  • 小：需要2-3个相关PR的功能
  • 中：跨越几个计划的重构
  • 大：长期战略方向，产生许多计划

目标 vs Erk-Plan

方面 Erk-Plan 目标
目的 单一可执行实现 协调2+个相关计划/PRs
范围 一个PR或紧密耦合的变更 多个计划朝向连贯目标
正文 机器可解析的元数据 人类可读的markdown
评论 会话上下文转储 操作日志 + 教训
标签 erk-plan erk-objective
工具 erk plan submit/implement 通过评论手动更新

关键设计原则

  1. 人类优先 - 纯markdown，无机器生成的元数据
  2. 增量捕获 - 每个操作都有自己的评论
  3. 教训为一等公民 - 每个操作评论包括教训学习
  4. 清晰路线图 - 状态在正文中一目了然
  5. 正文通过协调保持最新 - 每次PR落地后，代理审计散文部分与实际实现并纠正过时信息
  6. 钢铁线程优先 - 每个阶段以最小垂直切片开始，证明概念有效
  7. 每个阶段一个PR - 每个阶段大小为一个连贯的单个PR
  8. 始终可发货 - 系统在每次合并PR后保持功能正常
  9. 正文是真相源 - 正文始终包含完整当前状态；评论是变更日志
  10. 所有更改两步走 - 每个添加（上下文、决策、阶段）都获得评论和正文更新
  11. 上下文优于代码 - 提供模式引用，而不是规定性实现
  12. 会话交接就绪 - 正文应自包含，以便任何会话拾取并实施

快速参考

创建目标

gh issue create --title "目标: [标题]" --label "erk-objective" --body "$(cat <<'EOF'
# 目标: [标题]

> [1-2句摘要]

## 目标

[成功的样子 - 具体结束状态]

## 设计决策

1. **[决策名称]**: [决定的内容]

## 路线图

### 阶段 1: [名称] 钢铁线程 (1 PR)

最小垂直切片，证明概念有效。

| 节点 | 描述 | 状态 | PR |
|------|-------------|--------|-----|
| 1.1 | [最小基础设施] | 待定 | |
| 1.2 | [连接到一条命令] | 待定 | |

**测试:** [钢铁线程的端到端验收测试]

### 阶段 2: 完成 [名称] (1 PR)

填充剩余功能。

| 节点 | 描述 | 状态 | PR |
|------|-------------|--------|-----|
| 2.1 | [扩展到剩余命令] | 待定 | |
| 2.2 | [完整测试覆盖] | 待定 | |

**测试:** [完整验收标准]

EOF
)"

记录操作

完成工作后发布操作评论。完整模板参见format.md。

gh issue comment <issue-number> --body "$(cat <<'EOF'
## 操作: [简短标题]
**日期:** YYYY-MM-DD | **PR:** #123 | **阶段/节点:** 1.2
### 做了什么
### 教训学习
### 路线图更新
EOF
)"

发布后，更新问题正文（路线图状态，协调过时散文部分）。

查看目标

查看目标的依赖图、依赖项和下一个节点：

# CLI
erk objective view <issue-number>

# 斜杠命令（会话中）
/local:objective-view <issue-number>

生成Erk-Plan

为了实现特定路线图节点，创建引用目标的erk-plan：

erk plan create --title "实现[节点描述]" --body "目标 #123, 节点 1.2 的一部分"

工作流总结

  1. 创建目标 - 当开始多计划工作时
  2. 检查进度 - 查看依赖图和下一个节点
  3. 记录操作 - 完成每个重要工作后
  4. 更新正文 - 保持路线图状态最新，每次PR落地后协调过时散文
  5. 生成erk-plans - 用于单个实现节点
  6. 关闭 - 当目标实现或放弃时（当所有节点完成时主动询问）

资源

references/

  • format.md - 完整模板、示例和更新模式
  • workflow.md - 创建目标、生成计划、钢铁线程结构化
  • updating.md - 两步更新工作流的快速参考
  • closing.md - 关闭触发器和程序