用途：为 PR/分支保存跨会话的持久状态，避免依赖聊天历史。目录内含三类表面：issue-brief.md（该分支所处理 issue 的综合说明，仅在采纳或重新同步分支时重写）、pr-decisions.md（只追加的非显而易见决策日志，永久追加、只可取代不可编辑）、handoffs/ 与 handoffs-index.md（只追加的会话交接，索引指向最新一份）。实例文件按分支生成且被 git 忽略，脚手架（本文件、脚本、*.template.md）则提交入库。
会话开始默认流程：先用 git rev-parse --abbrev-ref HEAD 确认分支与简报的 branch 字段一致；读取 issue-brief.md、pr-decisions.md、handoffs-index.md；读取最新交接（索引最后一条指向 handoffs/ 下文件），无条目则从简报开始；若简报仍是空模板，先运行 /adopt-pr（已有 PR）或依据关联 issue 填写。
工作期间：做出非显而易见决策时，应在同一轮通过 append-pr-decision.sh 追加到 pr-decisions.md，而非事后补记。命令示例：.claude/skills/branch-context/append-pr-decision.sh --title "<short title>" --decision "<one-line decision>" --why "<one-line why>" --source "<source url -- mandatory>" [--iter N] [--supersedes "<earlier title>"]。推荐使用具名参数；位置顺序为 title decision why source [iter] [supersedes]。若决策重述模态表述（always/never/only if/must/unless），需逐字引用原句。
交接：每会话一份，最新在后，不得覆盖他人交接。命令：.claude/skills/branch-context/append-handoff.sh [--writer <name>] "<one-line summary>" [path-to-body.md]。正文必含 Done、Next、Commitments & constraints carried forward、Key paths、Open questions、Branch-context pointers 等小节；承诺与约束需逐字引用，不可压缩。仅在用户要求或已决定会话轮换时写交接，不要因“上下文快满”而写。
限制：不用于研究笔记或复现脚本；不用于超出该 PR 的长期代码库事实。辅助脚本还有 status.sh（输出 JSON 状态）。