用途:Objective 是协调文档,用于需要多个计划或 PR 才能完成的目标。与单次可执行实现的 erk-prs 不同,它跨相关工作追踪进度,并沿途记录经验教训。范围可小(2-3 个相关 PR 的功能)、中(跨多个计划的重构)或大(长期战略方向,派生多个计划)。
主要能力:支持创建目标、日志式记录行动、更新节点详情与状态、添加节点、查看依赖图与下一个节点、派生 erk-pr。目标体为人类可读 markdown,含目标、设计决策和分阶段路线图(每阶段 1 个 PR,steelthread 先行)。节点状态用 update-objective-node 程序化更新,随后用 erk objective check 校验。
使用方式:创建用 gh issue create 并打 erk-objective 标签;记录行动用 gh issue comment;节点更新用 erk exec update-objective-node <issue> --node <id> --status <status> 或 --pr '#1234';添加节点用 erk exec add-objective-node <issue> --phase <n> --description;查看用 erk objective view <issue-number> 或 /local:objective-view;派生计划用 erk pr create --file plan.md。
限制:必须使用程序化命令更新状态,不要手动编辑 YAML 或正文表格;正文为唯一事实来源,评论作为变更日志;每次变更需两步(评论 + 正文更新)。其他限制暂未提供。