okr-plan 用于创建和更新计划与行动,主要事实来源为 plan.md 和 actions/;当计划产生跨领域内容时,也可创建或修改 context/<slug>.md 及 context/index.md 条目,该条目 owner 为 okr-plan。
模式:new(尚无 plan.md,流程见 references/flow-new.md)、update(修改 plan/action/milestone,见 references/flow-update.md)、pre-confirmed(应用来自 okr-track deep 的结构变更,见 flow-update.md 与 okr-shared delegate-protocol)。
写入权限:plan.md 负责 Milestones 与创建计划时的 counters;actions/.md 负责 title、deadline、deps、effort、priority、DoD、quality criteria、notes、external_ids;context/index.md 仅限 okr-plan 作为 owner 的条目;context/.md 仅限 okr-plan 为 playbook、查表或辅助数据创建的文件。
前提:objective.md 必须存在,缺失需先 init;resources.md 建议存在,缺失会警告 cross-check fit。
原则:每个 action 必须有明确 DoD、Output/Deliverable 和质量标准;禁止无输出的模糊 action(如“进一步研究”);effort 为 xl 时必须设 Checkpoints 或拆分;先确认表格再写入,写入后再渲染 Roadmap。写入前需按 Preload Contract Tier 1 加载基础信息并应用相关 lesson,幂等,单独运行时自行补齐缺失部分。写入可达性:deliverable 为独立文件时,在 ## Output/Deliverable 开头写 Path: 行;创建 context/ 文件时需在 context/index.md 建 owner=okr-plan 的条目并加 confirm gate 分支 2;action 进入 actions/ 属分支 1,无需单独 confirm 行。
Schema 参考:references/data-format.md(plan.md 与 action frontmatter)、references/action-guide.md(高质量 action 与反模式)、references/task-format.md(action 文件正文模板);Roadmap 格式见 okr-shared skill schemas.md。