# Briefbound Development Cleanup > Use when a verified or integrated software change has concrete temporary artifacts, generated noise, task-owned background processes or listeners, stale claims, merged local branches, disposable worktrees, or a known PR lifecycle state that requires deferred or post-merge local closeout, or when the user explicitly asks to remove development residue or old branches. - Skill: `ccdawn/briefbound-development-cleanup` (Agent Skill, multi-file: 4 files) - Install (CLI): `npx skillmds@latest add ccdawn/briefbound-development-cleanup` - Raw SKILL.md: https://api.skillmd.com/api/skills/ccdawn/briefbound-development-cleanup/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - License: MIT - Author: CCDawn (https://skillmd.com/u/ccdawn) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/ccdawn/briefbound-development-cleanup --- # Briefbound Development Cleanup ## 目标 保护未合并工作和证据，清掉可证明噪音并收尾 branch、worktree 与 claim。 无法证明“可重建、已吸收、无 owner”就保留；清理不扩大范围。 ## Briefbound task contract - Context Boundary: 真实根目录、实现范围、验证、Git target/base/head、working tree、残留、task-owned PID/listener、worktree、claim 和清理授权。 - Output Contract: `CLEAN / NOOP / DEFERRED_INTEGRATION / BLOCKED`、已删除项、保留项、延后条件、清理后证据和 Route Out。 - Allowed Action: 先只读审计；只删除已证明属于本轮且可重建的本地残留，只停止已证明由本任务启动或依赖的精确进程树。删除本地 branch/worktree 需用户明确清理、项目长期策略，或同一任务“完成开发到 PR”许可且已验证 PR 合并。远程分支、push、合并、发布和无法归属的文件或进程不自动处理。 - Success Evidence: 清理后 Git、worktree 和 registry 符合预期；源码、用户改动、未合并提交和必要证据仍在。 - Stop Condition: 根目录或 integration target 不明、工作区 dirty 且归属不清、process owner 或 data root 不明、branch 未吸收、worktree 被占用、claim 仍 active、路径安全无法证明、删除需要远程或 force 动作。 - Route Out: 当前开发 owner、`briefbound-autonomous-collaboration-loop`、`briefbound-thread-coordination`、`briefbound-pr-review`、`briefbound-router` 或 BLOCKED。 ## 统一调用契约 - 只处理 Briefbound task contract 范围；不匹配时回 `briefbound-router` 或更具体 owner，复合任务不吞其他 owner。 - 用户可见内容默认中文，完成只报状态、产出、证据和剩余风险；代码、命令、路径、错误原文、API/协议、skill 名和枚举保留原样；Route Out 仅以 Briefbound task contract 为准，末行写 `下一步建议: <一个具体动作>`。 ## 进入时机 - 只有当前任务已知创建了临时产物、任务专用缓存、scratch 文件、后台进程/listener、claim、feature branch/worktree，或用户明确要求清理时，才做静默清理检查并加载本 skill。 - 没有已知候选时直接收口，不扫描全仓寻找可能的噪音，也不输出 `NOOP`。 - 合并前清理开发残留，但保留仍用于 PR/合并的 branch/worktree，状态为 `DEFERRED_INTEGRATION`；合并后再次收尾这些 Git 资源。 - 纯规划、只读审查、研究归档或未验证开发不进入删除阶段。 - 由 `briefbound-autonomous-collaboration-loop` 调用时，沿用其本轮安全本地清理授权；已证明被本地 `main` 吸收的任务 branch/worktree 和已完成 claim 不再逐项询问。 ## Post-PR Closeout Gate 同一任务 PR 读取 `references/post-pr-closeout.md`：`PR_OPEN` 关闭空闲 claim 并保留 Git 现场，`PR_MERGED` 验证吸收后本地收尾，`PR_CLOSED_UNMERGED` 保留工作；远程分支删除必须单独授权。 ## 审计与分类 先确认真实 repo root、当前 branch、integration target 和本轮 owned surface，再读取： - `git status --short --branch`、相关 diff、untracked/ignored 候选； - `git worktree list --porcelain` 和本地分支占用； - `git merge-base --is-ancestor ` 或等价吸收证据； - coordination registry 中的 Agent/claim 状态； - 项目规则、官方 closeout 命令和 Windows junction/reparse point。 把候选分成四类： - `REMOVE_NOW`：本轮创建、可重建、删除后不影响行为或证据。 - `CLOSE_AFTER_INTEGRATION`：当前 feature branch/worktree 已完成但尚未被 target 吸收。 - `KEEP`：源码、用户内容、验收证据、未合并提交、归属不明或仍被依赖。 - `BLOCKED`：删除需要 force、远程动作、所有权裁决或路径风险未解除。 ## 噪音清理 - 只按明确的 literal path 删除，不使用 `git clean -fdx`、仓库根目录递归删除或宽泛通配符。 - `git clean -ndX` 只能用于预览；`node_modules`、`.venv`、下载缓存、模型/数据、密钥、用户日志和共享依赖默认保留。 - patch、scratch、测试/构建缓存、截图和日志仅在本轮创建或规则明确可丢弃时删除。 - 多会话的可重建测试缓存最终统一处理；删除受阻且不影响 tracked 交付时，记录候选并停止换命令。 - accepted plan、迁移、lockfile、fixture、snapshot、基准结果和失败复现不是噪音，除非已有替代且用户明确同意。 - 不修改 `.gitignore` 来隐藏无法解释的残留；先判断它为何存在。 ## 本地资源收尾 关闭 branch、worktree、claim 或 task-owned runtime 时读取 `references/local-resource-closeout.md`；禁止 force 删除 dirty worktree。 ## 执行与验证 1. 先输出或内部建立候选分类；有安全候选才执行。 2. 按 exact path 和单个 Git 对象逐项清理，每一步失败就停止扩大动作。 3. 重新读取 Git、worktree 和 registry；清理触及源码、依赖或运行环境时才重跑受影响验证，普通缓存删除不重复完整测试套件。 4. 工作区只剩预期源码/文档变更，或已 clean；所有延后项都有明确触发条件。 ## 低噪声输出 误路由后无候选时直接返回原 owner，不输出清理报告。有动作时仅汇报：已清理、保留/延后、验证证据和一个下一步建议；不打印完整文件树、全部分支或命令日志。 只有远程删除、force、dirty/未合并内容、归属冲突或路径不确定时才停下来询问。用户已明确授权的安全本地清理不重复确认。 用户可见输出默认中文，代码、命令、路径、Git 状态和 skill 名保留英文。正文最后一行使用：`下一步建议: <一个具体动作>`。