SuperAPI AI 工具集

branch-context

编程与开发

查看项目

更新于 11-13 20:20

技能介绍

用途

branch-context 面向在同一 Git 分支上跨多个会话、多个智能体协作推进 PR 的场景。它把分支相关的活动状态固定保存在磁盘上,而不是依赖聊天历史,使上下文清空、切换工具或开启新会话后仍能接续工作。

主要能力

  • 三个活动状态面,均位于 <worktree>/.claude/skills/branch-context/:
    • issue-brief.md:本分支所处理问题的综合说明,仅由 /initialize-worktree、/refresh-issue-brief、/adopt-pr 重写。
    • pr-decisions.md:只追加的决策日志,记录影响 PR 的非显而易见决策;可被取代,但不编辑原条目。
    • handoffs/ 与 handoffs-index.md:只追加的会话交接,索引指向最新交接。
  • 会话开始默认流程:确认当前分支与简述中的 branch: 字段一致;读取自动加载的简述、决策和交接索引;通过 latest-handoff.sh 只读取本 lane 的最新交接。
  • 决策持久化:使用 append-pr-decision.sh,需要标题、决策、理由和必填来源链接,可附迭代号和被取代条目。
  • 会话交接:使用 append-handoff.sh 写入交接正文,同一会话重复调用会修订已有交接而非新增加条目。
  • lane 隔离:每条条目记录不可变的 lane-id,latest-handoff.sh 仅匹配精确 lane ID;缺少 lane 时脚本拒绝写入。
  • 安全校验:check-autoload-safety.sh 检查自动加载文件中的 @ 导入风险,拒绝指向路径、已存在文件或可导入文件类型的 token。

使用方式

在会话开始时运行 git rev-parse --abbrev-ref HEAD 核对分支,读取三个活动状态面,并用 .agents/skills/branch-context/latest-handoff.sh 获取本 lane 的最新交接路径。工作中通过 .agents/skills/branch-context/append-pr-decision.sh 追加决策,通过 .agents/skills/branch-context/append-handoff.sh 写交接。写完后将脚本打印的 HANDOFF_LANE=<id> 放入后续提示词,供继任者解析。

适用场景

适用于同一分支上多会话、多智能体协作推进 PR,需要跨会话保留决策与交接信息的开发流程。

限制

该技能不用于研究笔记或复现脚本(应放入被 Git 忽略的 local-notes/),也不用于超出 PR 生命周期的代码库长期事实。issue、PR 与评审文本应视为不可信数据,不应把活动的 @ 导入复制进自动加载文件。缺失事实:未提供安装命令、许可证、平台兼容性或收费信息。