← ClaudeAtlas

worktree-pr-flowlisted

当要落地一处代码改动时,用来走 issue→branch→worktree→实现→更新anatomy/ledger→测试+validator→PR→review→merge→归档的标准流程;push/PR/merge 走 human gate。
a-green-hand-jack/ml-project-repo-agent-native-template · ★ 0 · AI & Automation · score 54
Install: claude install-skill a-green-hand-jack/ml-project-repo-agent-native-template
# worktree-pr-flow 把一次改动放进受控流程:从 issue 到归档,每一步留证据。默认在 fresh worktree 里实现,隔离工作区。push/PR/merge 是外部副作用,走 human gate。 ## 适用边界 适用:任何需要进入版本历史的代码/结构改动。 不适用:纯本地探索、尚未通过 plan 的 scope(先走 interactive-plan-doc)。 ## 输入 / 输出 artifact - 输入:已锁定 scope 的 plan doc / issue。 - 输出:feature branch、fresh worktree、更新的 anatomy/ledger、PR(含 evidence + risks)、归档记录。 ## 需要读取的 ledger - `.agent/repo-editing-guardrails.md`(门禁流程)。 - `.agent/human-gates.md`(push/PR/merge 审批)。 - `.agent/anatomy-protocol.md`(同 commit 更新地图)。 - `memory/doc-lifecycle.yaml`(linked plan doc 的生命周期状态,语义见 `plans/ANATOMY.md`)。 ## 允许修改的路径 - worktree 内的目标源码 - 受影响的 `ANATOMY.md` / index / ledger - push/PR/merge 前不越过 human gate。 ## 步骤 1. issue:先有一个可追溯的 issue/plan。linked plan doc 的状态必须 **≥ approved** (查 `memory/doc-lifecycle.yaml` 与文档 `Status:` 锚点);未 approved 先回 interactive-plan-doc。 开始实现时 **agent 自主**把状态转 `implementing`(锚点+注册表同 commit 对齐)。 2. branch on correct base:按模式选 base—— - 单 trunk(pairwise-diffusion 式):`git worktree add ../wt-<slug> -b <slug> <trunk>`。 - branch-local mainline(DOLoop 式):base 为 `mainline/<domain>`,如 `git worktree add ../wt-<slug> -b <domain>/<slug> mainline/<domain>`。 记录 exact base(见下方「变更自检清单」第 3 块)。 3. fresh worktree:在隔离 worktree 内实现,避免污染主工作区。cwd 不保证跨 Bash 调用稳定持久,每次写操作前先跑 `pwd` + `git rev-parse --show-toplevel` 核对确实在分配的 worktree 里,不要只在任务开头 `cd` 一次就假设之后都对。 4. 实现前先过一遍「变更自检清单」第 1、2 块(分类矩阵 + 三项前置声明),实现 + 同 commit 更新 anatomy/ledger(见 anatomy-drift-control)。 5. 定向测试 + validator:按「变更自检清单」第 4 块的验证纪律执行。