ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

opencodex devlog 混合式完成判定(Hybrid Reclass)方法论:从 `_plan` 到 `_fin` 的归档决策实践

opencodex devlog 混合式完成判定(Hybrid Reclass)方法论:从 `_plan` 到 `_fin` 的归档决策实践 【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载本篇技术指南基于 opencodex 仓库内 devlog 治理实践文档000_interview_package.md展开系统讲解该仓库如何在大规模规划单元_plan中判定哪些工作单元真正完成、可以移入_fin归档哪些仍有核心残留必须留在_plan的决策方法。读完本文你将掌握一套可复用的HYBRID 混合式完成判定标准KEEP / MOVE_WITH_MEMO / BLOCKED 三态标签、核心残留与延迟抛光的区分准则以及伴随归档动作生成 inventory、residual-active 备忘录与最终目录树的完整执行链路。背景为什么 devlog 需要重新分类opencodex 仓库的 devlog/README.md 明确规定了规划笔记的存放规则_plan/—— 仍处于开放状态的单元每个单元一个目录内含按十进制编号的文档000_计划、030_验证、090/100收尾等_fin/—— 已关闭的单元其最终结论DONE、NOOP、BLOCKED、NEEDS_HUMAN及原因已被记录后才允许移入_chase/—— 用于外部参考材料如各上游客户端协议的 parity 对照资料。260723_ambiguous_reclass_interview这一单元要解决的问题是当_plan下积累了数十个新旧混杂的工作单元时如何批量、可审计地判定每个单元的去向。文档记录了一次以 Clarification澄清 模式进行的决策会话Session019f8e04-4172-7260-982d-891794bdbd98其 Loop archetype 为spec-satisfaction——即由子代理验证的残留分类来定义完成done而不是靠主观感觉收尾。核心方法论HYBRID 混合式完成策略采访过程经历多轮冲突消解后最终把完成策略收敛为HYBRID混合式其核心思想是完成不是一个二值判断而是把每个单元拆成核心残留core residual与延迟抛光deferred polish两部分分别对待。这一策略直接解决了旧式归档的两个痛点全部搬走激进策略会把未完成的单元伪装成已完成污染_fin的可信度全部留下保守策略会让已具备充分证据、仅剩收尾杂项的单元长期滞留_plan归档效率低下。HYBRID 的落地要点来自采访包的 Settled answers如下决策项定稿结论完成策略HYBRID核心残留阻止移动延迟抛光可携带备忘录移动执行分支使用现有 dev 工作树/Users/jun/.codex/worktrees/f655/opencodexHEADdd8eda0f领先 origin/dev 3 个提交不切换主预览 checkout目标集该工作树上所有当前_plan单元采访结束时实测为 12 个残留处理核心残留单元留在_plan不动延迟抛光可随residual-active.md备忘录一并移动无需新建 ACTIVE 文件夹验证要求移动前必须由子代理验证核心残留为 0判定准则Core vs Deferred Rubric可复用清单文档中最具实操价值的部分是核心残留 vs 延迟抛光的判定规则表。它给出了哪些情况必须阻止归档、哪些情况可以带备忘归档的明确判据核心残留KEEP in_plan永不移动必要实现仍处于待完成/未实现状态单元宣称的功能代码还没落地存在显式开放队列且这正是单元存在的目的例如开放 PR / issue 的 triage 仍在进行中队列未清空验证清单为空且没有任何实测结果单元声称已完成但拿不出测量数据纯计划型单元没有任何执行证据只有计划文档没有代码、测试或合并记录支撑。延迟抛光MOVE residual memo 允许被明确命名的范围外残留named out-of-scope residual比如GUI shadow-intercept 字符串不在本次范围代码落地后的后续 GUI / 文档打磨功能已上线剩下的是界面文案或文档微调被接受的已知限制accepted known limitation团队明确接受该限制不阻塞交付已有代码测试证据、但延迟做 live smoke实时冒烟测试可以后补不构成完成性障碍。这套规则的意义在于把感觉上做完了转化为可核查的判据KEEP 的四条全部指向证据缺失或目的未达成MOVE 的四条全部指向证据已具备、剩余项不阻塞。采访包结构一次规范决策会话的产物000_interview_package.md本身就是一个可复制的决策包模板包含Settled answers定稿答案5 条覆盖策略、分支、目标集、残留处理、验证要求Dimension readiness维度就绪度表对 Goal / Constraint / Success criteria / Ontology 四个维度打分满分 3并列出各自的 KnownsGoal目标对整个_plan在 f655/dev 上重新分类只把 hybrid 合格单元移入_fin记录残留Constraint约束只在 f655 工作树内操作不碰产品代码不 push不覆盖no clobber嵌套 git 永不移动主预览 checkout 不动Success criteria成功标准核心残留被阻断延迟抛光可携带备忘录移动必须有子代理验证inventory 移动日志 residual 备忘录构成证据Ontology本体标签体系 KEEP / MOVE_WITH_MEMO / BLOCKED单元居所_planvs_finresidual-active.md作为中央备忘录。OPEN ASSUMPTIONS开放假设记录但不阻塞4 条包括采访/会话追踪器留在主仓库.codexclaw/文件移动在 f655 工作树执行、目的地冲突时跳过并上报、绝不覆盖、旧计划文档中的历史矛盾是分类输入而非阻塞、当前主 checkout 在 Plan/Build 期间保持previewScan rounds扫描轮次R1–R3 暴露分支/策略冲突并由后续回答消解R4 定稿包剩余项是 Plan 落地 逐单元子代理验证Next下一步等待用户 forkProceed / 更多问题 / 暂停。这种先对齐维度、再记录假设、最后分轮扫描消解冲突的流程保证了大批量归档决策的可追溯性——每一个 KEEP 或 MOVE 结论都能反查到对应证据。执行产物residual-active 备忘录与最终目录树配合采访包仓库中保留了完整的执行证据链这三份文档共同构成了移动必须留下审计痕迹的落地010_f655_residual_active.md与260723_dev_plan_hybrid_sweep/residual-active.md内容一致中央备忘录记录测量时间戳、工作树、HEAD、策略并把 12 个单元逐一分类020_f655_inventory.md12 个单元的 inventory 清单逐行标注MOVE/OK或KEEP040_f655_final_tree.md移动后的最终目录树快照。MOVE_WITH_MEMO 的实际判定5 个单元单元证据延迟残留260723_issue_fixes040_loop_closeout.md DONE commits 绿色 gatesGUI shadow-intercept 字符串范围外docs-site 本地构建跳过CI 覆盖#252 live enum-acceptance smoke 延迟260723_issue_triage009_triage_result.md 最终分桶 fix commit 表#290 保持开放 needs-infoissue 残留单元已关PR 拆分决策留给用户260722_issue_bug_sweep040_merge_readiness_review.md CI 绿 merge-readydev→main/preview 合并需用户批准在单元外260723_open_pr_review100_merge_records.md push a0b9688d..3a87829f#306 等 CIGUI 审批#325 push 后新 PR 未 triage260723_overnight_pr_review000_plan 决策 090/100 关闭文档齐备已关闭 PR 的重建想法是未来工作KEEP in_plan的实际判定7 个单元单元证据缺口核心残留260721_sidebar_diet无单元级 DONE closeout只有分阶段计划 截图外部 goalplan 标准未在单元内被证明260701_codex-catalog-splitORACLE 已落地但文件拆分 DEFERRED单元目的未完成260722_repo_governance_config只有 000_plan.md纯计划合并后冒烟测试仍是未来事项260723_antigravity_usage_model_unify030_verify_closeout.md 只是验证矩阵没有 DONE 实测结果260723_issue_triage_r2开放集仍存在后续工作阶段已列出500_storage-page-session-cleanup90_open-questions.md 的复选框未勾选配送阶段问题未决issue_017_mobile-thread-bypass-proxy仅 review等待 reporter reprodocs 后续未关闭这 7 个 KEEP 单元的判定完美对应 rubric 中的四类核心残留——没有一条是基于主观印象全部锚定在具体文件的证据状态上。关键约束与操作纪律采访包中反复强调的约束值得单列因为它们决定了归档操作的安全边界分支纪律移动只在 f655 工作树执行主 checkout 保持在preview避免污染预览分支No clobber 原则目标目录若已存在同名单元跳过并上报绝不覆盖——这防止了归档操作破坏已有记录嵌套 git 永不移动与 devlog/README.md 的 Submodule hygiene 规则一致——嵌套.git会成为父索引中的160000gitlink破坏actions/checkout移动前验证核心残留为 0 才可移动且验证必须由子代理完成对应 Loop archetype 的 spec-satisfaction 定义安全边界devlog 目录是公开的未披露的安全发现、草稿公告、exploit 路径绝不允许出现在_plan/_fin中——公开即披露历史难以清除。可复制性这套方法论适用于什么场景HYBRID reclass 方法论并不局限于 opencodex 自身它可以被任何以目录即状态方式组织工程笔记的仓库复用当你的_plan目录积累了大量跨批次、新旧混杂的工作单元时先用 dimension readiness 表对齐 Goal / Constraint / Success criteria / Ontology 四个维度为每个单元建立证据 残留双栏评审用 KEEP / MOVE_WITH_MEMO / BLOCKED 三态标签标注移动时同步生成 inventory、residual-active 备忘录、final tree 三件套确保任何人在三个月后仍能复现为什么这个单元被搬走/被留下把已有代码测试证据与只有计划无执行作为最强的两类信号前者允许带备忘移动后者必须留下。对于正在管理大型 AI 协作仓库、或希望为自身项目建立可审计归档流水线的团队这套核心残留阻断、延迟抛光带备忘放行的混合策略是一个经过真实批次12 个单元、5 移 7 留验证的实操模板。赞分享【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址https://gitcode.com/gh_mirrors/ope/opencodex点击查看免费下载相关推荐OpenCodex devlog 单元闭合判定实战_plan → _fin 混合重分类与 f655 清单扫描OpenCodex devlog 单元闭合判定实战_plan → _fin 混合重分类与 f655 清单扫描 本篇基于 OpenCodex 仓库 devlogOpenCodex 的 devlog 归档分类协议基于活体证据的 _plan → _fin 单元判定与迁移OpenCodex 的 devlog 归档分类协议基于活体证据的 _plan → _fin 单元判定与迁移 本文围绕 OpenCodex 仓库中 001_inOpenCodex devlog 清理实战FINISHED-only 安全归档移动协议_plan → _finOpenCodex devlog 清理实战FINISHED only 安全归档移动协议_plan → _fin 本文基于 OpenCodex 仓库 dev创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进