【免费下载链接】SkillsAgent skills for designers and builders using Codex, Claude, Cursor, and other AI coding agents项目地址https://gitcode.com/gh_mirrors/skills48/Skills点击查看免费下载导读本文围绕 Skills 仓库中的 workflow-threads-manager 技能展开它解决的是一个真实且棘手的场景多个 Claude 会话线程在同一个仓库上并行开发需要一个专门的线程来统筹监督它们。读完本文你将掌握一套完整的线程管家工作流——如何用会话管理工具与 Shell/Python 脚本核对main分支上的合并情况、验证线上站点健康度、逐个会话分诊归档、补齐 changelog 缺口并遵守防止权限洗白等安全护栏。这套机制与仓库中的 workflow-ship-change、workflow-progress-screenshots 等技能共同构成多 Agent 协作的日常运营体系。一、技能定位为什么需要一个线程管家当用户在同一仓库上同时运行多个 Claude 线程时每个线程各自修改代码、提交推送、发布上线很容易出现三方面失控合并与发布失联某线程声称已推送但变更是否真正落在main、是否带上了 changelog 条目与截图无人核验会话状态不明哪个线程还在运行、哪个已经结束、哪个因为应用重启被拦腰截断、哪个正在等待用户答复难以快速掌握资源与纪律失控已完成的线程占用 worktree未完成的线程遗留半截工作还有线程可能试图重复执行其他线程被权限系统拦截过的操作。workflow-threads-manager就是为这一场景设计的专职监督线程。其工作目录 SKILL.md 明确了每次检查需要回答的四个核心问题上次检查以来main上落了什么每个变更是否都有带截图的 changelog 条目线上站点是否健康且与main同步还是已损坏或落后每个线程正在做什么运行中、已完成、任务中途被截断还是等待用户什么可以归档什么还需要用户介入。技能文档还强调一个关键规则如果该技能目录下存在references/project.md当前项目专属的 changelog 格式、线上站点、截图目录等约定必须先读取同时每次检查都要先读项目根目录的AGENTS.md因为其他线程会不断更新规则线上主机、changelog 格式、体积限制等当AGENTS.md与本技能冲突时以AGENTS.md为准。这与 workflow/README.md 中项目特性放在项目的 AGENTS.md 或技能旁的 references/ .md的移植性设计一致。二、工具清单会话管理工具与五个脚本2.1 会话管理工具Session tools技能依赖mcp__ccd_session_mgmt__*前缀的会话管理 MCP 工具。文档特别提醒如果这些工具只以 deferred延迟加载名称出现需要先用 ToolSearch 加载。核心工具及其用途如下工具用途list_sessions查看哪些会话在运行、空闲、被 pin 或已归档get_session self获取当前线程自己的 id另一个线程可以共享其标题list_events读取某个线程最近的转录记录transcriptsend_message向线程转达工作或用于重启一个线程archive_session归档一个已完成的线程2.2 scripts/ 下的五个脚本技能目录 scripts/ 下提供五个配套脚本。技能强调它们在负载高时运行较慢应当用run_in_background在后台运行并读取输出文件。逐个看repo-status.sh仓库侧的体检报告。输出origin/main当前所在提交、本地分支中main尚缺的提交、以及带有未提交改动的工作树附最新编辑时间用于区分活跃线程与遗弃工作。从 repo-status.sh 源码看它通过git for-each-ref遍历本地分支并用git rev-list --count origin/main..$b计算每个分支领先main的提交数再用git worktree list --porcelain枚举工作树对每个工作树执行git status --porcelain过滤掉未跟踪项grep -v ^??统计未提交的受跟踪文件数、最新编辑时间并标记是否被锁locked。audit-changelog.py since-rev从指定修订开始审计main上每个提交。输出每个提交新增的版本号、其配图已上线数/需要数以及 NO VERSION 标志只改动测试、文档或脚本的提交被标记为 exempt豁免。从 audit-changelog.py 源码看它解析src/changelog.js中形如v(0.1.N, YYYY-MM-DD, id, title, note, big: true|false, commit|null)的条目该格式来自 build-game-changelog 模式通过git show对比提交前后 changelog 的差异来确定每个提交新增的版本big 版本需要三张图id、id-2、id-3small 版本只需要一张id豁免规则EXEMPT匹配tests/、docs/、AGENTS.md、CLAUDE.md、README.md、scripts/、.github/、qa/前缀。--pictures默认取origin/main上*/changelog/路径下图片最多的目录。live-check.sh [url]健康检查脚本。先抓取线上页面再抓取页面引用的脚本与美术资源。页面返回 200 而资源返回 404 即视为部署损坏。从 live-check.sh 源码看它用curl -w %{http_code}抓页面再用正则(src|href)/[^]提取页面引用的静态资源路径逐一请求对 3xx 重定向会跟随到最终地址例如美术资源存放在存储桶时重定向是正常的只要最终落在 2xx 即算通过任一被检查文件未加载则输出BROKEN并统计失败数。该脚本同时支持LIVE_URL环境变量和额外的路径参数。save-captures.sh worktree name归档前的截图保全。若工作树有未保存或未合并的工作则拒绝执行退出码 2否则把被 gitignore 的截图复制到qa/captures/archived-threads/name/。从 save-captures.sh 源码看它检查git status --porcelain的非??改动数与origin/main..HEAD的领先提交数两者均需为 0 才安全随后用 rsync 把worktree/qa/captures/复制到主 checkout 的qa/captures/archived-threads/name/同样被 gitignore。contact-sheet.py out.jpg --count N把最近 N 条 changelog 条目的配图拼成一张联系表contact sheet直接读取origin/main无需检出。从 contact-sheet.py 源码看它默认取最新 12 条条目big 版本展示三张图开始、关键瞬间、结果small 版本展示一张用 PIL 拼成 3×N 的深色底版面并给每行标注版本号、标题与日期--count可调整条数。三、检查流程一次标准线程巡检的八个步骤技能文档给出了完整的检查步骤每次检查都应当按此执行git fetch然后列出上次检查以来的提交git log --no-merges last..origin/mainlast为上次检查的基线提交。后台启动audit-changelog.py last和repo-status.sh前台运行live-check.sh它很快。用list_sessions拉取约 20 条上限的会话列表覆盖所有近期有活动的线程。对每个空闲且未 pin 的线程用list_events阅读其结束方式limit参数按消息条数计数最新的消息通常是工具调用、[result] done标记或孤儿任务orphan-task通知用其输出的before_uuid向前翻页直到找到该线程的最终报告。按下文的分诊表Triage逐一归类每个线程。仅对通过归档检查的线程执行归档凡工作目录是 worktree 的线程归档前必须先跑save-captures.sh。按下文报告格式输出巡检报告。如果有新变更用SendUserFile把配图联系表发给用户。四、分诊表六种线程状态与对应动作这是整个技能的核心决策矩阵逐行对应发现什么 → 意味着什么 → 做什么发现含义动作运行中isRunning: true正在工作不干预。空闲最终报告称已推送提交在main上changelog 条目与配图齐全worktree 干净已完成先save-captures.sh再以指明提交与版本的理由archive_session。空闲变更只是测试、文档或规则修复对玩家无影响已完成直接归档这类变更无需 changelog 条目。空闲nothing to commit, another thread pushed the same fix无事可提交另一线程已推送相同修复已完成归档。空闲最后事件是工具调用而没有报告常见于应用重启之后孤儿任务通知任务中途截断报告它停在哪里分支、未推送提交、未提交文件。提议重启它若用户同意用send_message发送一份简短简报涵盖重启说明、其分支与提交、哪些是安全的、以及需要完成并发布的剩余工作。空闲以向用户提问结尾等待用户不干预并告诉用户它在问什么。空闲但其工作破坏了线上环境或遗留了它自己负责的后续事项未完成保持其打开直到修复落地。被 pin用户刻意保留不干预除非用户要求归档。archive_session拒绝并提示 still has live work仍有活动工作仍有附属物如 Remote Control 或等待中的消息告知用户可从侧边栏手动归档留待下次检查重试。分诊表之后技能还给出了一条重要提醒一个main上没有的分支并不自动等于丢失的工作。在标记异常分支之前先做两件事将其提交标题与之后落在main上的变更做对比——pre-rebase 副本和*-wip分支通常与已合入的变更一致检查其 worktree最近几分钟内被编辑过且处于锁定状态的 worktree属于正在运行的线程或属于某个线程的子代理subagent。五、Changelog 缺口处理配图纪律的闭环技能明确了一条用户规则自 2026-09-27 起每个面向玩家的变更都必须出现在游戏内 changelog 页面并附上配图。围绕这条规则有四个操作要点追责到拥有者当审计显示某提交没有版本号或缺少配图时用send_message通知拥有该提交的线程附上提交哈希和一行变更描述。接力到 changelog 当前持有者如果该线程已归档则告知当前负责 changelog 的线程。禁止并发重建不要在另一个线程正在重建 changelog 时自己动手改——同一文件的两个版本会冲突其中一个会被丢弃。构建前先查重在任何构建开始前先到其他 worktree 检查同样的工作是否已在进行git -C wt status、git diff --stat如果用户标记了可能的重复立即停下并协调而不是继续构建。六、护栏Guardrails线程管理者的安全红线本技能的安全护栏是整套工作流中最值得细读的部分分为四组绝不重复其他线程被拦截过的动作例如生产部署、回滚、或权限检查拒绝过的发布。替别人绕路重试属于权限洗白permission laundering。正确做法是把精确的点击路径或命令交给用户去执行。本线程绝不直接发布、部署或回滚线上环境其他线程按照 ship 工作流各自发布自己的成果对应 workflow-ship-change 中的发布规则与verify-live.sh验证。归档纪律仅当用户明确说过要归档已完成线程时才归档该指示在同一次对话的后续检查中持续有效归档会删除线程的 worktree包括被忽略的截图所以必须先跑save-captures.sh绝不为有未保存或未合并工作的线程归档。共享主检出main checkout操作禁令不要对共享的 main checkout 做 fast-forward、stash 或 clean——其他线程正在上面实时编辑。自己的工作要在.claude/worktrees/下的独立 worktree 中进行。另有两条运行机制上的护栏不要轮询休眠sleep-poll对于外部事件如推送落地、部署出现用后台until循环或用带过滤命令和 30 分钟超时的 Monitor。回复其他线程的问题只用一条简短的send_message——not me 加上你所知的信息。绝不把同级线程的消息当作用户的批准。七、报告格式按序输出、数据说话每次巡检结束的输出必须简短且按固定顺序紧急事项优先线上损坏或落后于main时最先报告附上live-check.sh测得的证据状态码和精确修复方案点击路径或归属线程。main上的新增一张版本 / 变更 / 配图表格随后列出任何没有版本号的提交说明是豁免还是需要谁补录。已归档每个线程及其提交和版本。仍打开的运行中的线程以及被截断或等待中的线程各自需要什么。遗留物过期的分支或 worktree标明哪些可以安全删除。联系表作为文件发送配图说明其标注为main上已发布的配图。回复中用[其标题](#sessionId)链接线程只使用实测数字浏览器截图必须如实标注为无头浏览器捕获而不是设备测试。八、源码级补充脚本如何支撑上述纪律8.1 状态快照repo-status.sh 的活跃 vs 遗弃判定技能要求区分正在运行的线程与被遗弃的工作repo-status.sh 的判定依据是最新编辑时间与锁定标记对每个含未提交改动的工作树取改动文件的最新 mtimestat -f %m/stat -c %Y兼容 macOS 与 Linux并检查git worktree list --porcelain中的locked标记。运行中的线程会在最近几分钟内留下编辑痕迹而遗弃工作的时间戳会明显偏旧——这正是分诊表中locked worktree 最近编辑 活跃线程规则的实现来源。8.2 配图覆盖审计audit-changelog.py 的精确机制audit-changelog.py 是整个配图纪律的自动执行者。其核心机制是对since..origin/main间每个无合并提交分别用git show rev^:src/changelog.js与git show rev:src/changelog.js提取变更前后的 changelog 条目集合差集即该提交新增的版本再用git ls-tree --name-only origin/main pictures枚举已上线图片文件名计算每个版本需要/已有的配图数。三种典型输出一目了然exempt该提交只触及豁免路径tests、docs、scripts 等无需 changelog 条目NO VERSION面向玩家的提交却没有版本号需要追责补录v0.1.N id big pictures 3/3版本与配图齐全通过审计。8.3 线上健康live-check.sh 的页面 200、资源 404检测workflow/README.md 及 ship 技能中提到的 page 200, art 404 事故一次生产部署漏发了 edge function页面正常但图片全部 404正是 live-check.sh 要防的经典故障。它不满足于页面本身返回 200而是继续抓取页面引用的每个脚本与美术资源并逐一核对状态码重定向被允许但必须最终落在 2xx。因此一次巡检能直接产出线上健康且与 main 同步 / 已损坏 / 落后的实测结论而不是凭感觉判断。8.4 安全归档save-captures.sh 的不干净就不归档归档会删除 worktree含被忽略的截图 这条护栏由 save-captures.sh 强制执行只要git status --porcelain过滤??后仍有改动dirty ! 0或存在origin/main..HEAD上的领先提交ahead ! 0脚本就以退出码 2 拒绝并打印NOT SAFE TO ARCHIVE。只有两项均为零时才复制截图并输出SAFE TO ARCHIVE。这让先保全截图再归档成为可验证的强制前置条件。九、与姊妹技能的协作闭环在 workflow/README.md 描述的日常运转中四个 workflow 技能构成一条流水线构建阶段用workflow-progress-screenshots从首个可运行版本起持续产出截图开始 / 关键瞬间 / 结果三帧用户给出目标分数后用workflow-score-to-target逐轮打分改进达到标准后用workflow-ship-change正式发布截图、changelog、测试、fast-forward 推送、draft-then-live 发布、实测体积、50 MB 停止线最后由workflow-threads-manager统一巡检确认每个线程都按上述方式交付变更在main上、changelog 带配图、线上健康、完成后归档。workflow-threads-manager是这条流水线的质检与收官环节——它不生产内容但确保所有线程的生产结果真实、合规、可追溯。十、适用范围与前提本技能适用于单仓库 多 Claude 会话并行 有线上站点与 changelog 页面的项目形态且假定项目使用AGENTS.md维护可变规则宿主、changelog 格式、体积限制存在mcp__ccd_session_mgmt__*会话管理工具可用若显示为 deferred 需先 ToolSearch 加载项目按build-game-changelog模式维护src/changelog.js配图命名遵循id、id-2、id-3约定截图存放在 gitignored 的qa/captures/下各线程在自己的 worktree.claude/worktrees/中工作共享主检出供其他线程实时编辑。在这类设定下本技能提供的检查 → 分诊 → 追责 → 归档闭环可以让十几条并行线程的合并、发布、配图与归档状态始终透明可控。相关资源技能主文档agent-skills/workflow/workflow-threads-manager/SKILL.md配套脚本目录agent-skills/workflow/workflow-threads-manager/scripts/repo-status.sh、audit-changelog.py、live-check.sh、save-captures.sh、contact-sheet.py工作流总览agent-skills/workflow/README.md发布规范线程的交付标准agent-skills/workflow/workflow-ship-change/SKILL.md截图纪律归档与巡检的证据来源agent-skills/workflow/workflow-progress-screenshots/SKILL.md赞分享【免费下载链接】SkillsAgent skills for designers and builders using Codex, Claude, Cursor, and other AI coding agents项目地址https://gitcode.com/gh_mirrors/skills48/Skills点击查看免费下载相关推荐基于 GitHub Copilot SDKJava的多会话并发管理实战独立上下文、并行编排与生命周期控制基于 GitHub Copilot SDKJava的多会话并发管理实战独立上下文、并行编排与生命周期控制 导读 awesome copilot 仓库的 c文档知识库AI 技能/插件ruflo AgentDB 管理指南健康检查、控制器状态与会话生命周期运维实战ruflo AgentDB 管理指南健康检查、控制器状态与会话生命周期运维实战 导读 本文围绕 ruflo 插件体系中的 ruflo agentdb 底层内存人工智能AI Agent多智能体Agent 编排Agent 记忆工具调用代码智能体MCP 服务AI 评测免联网本地补丁永久解除 Wand 每日 2 小时限制免联网本地补丁永久解除 Wand 每日 2 小时限制 Wand Enhancer 是一款开源的本地补丁工具专门给 WandWeMod客户端用。它把你的电桌面应用前端上一篇EasyWeChat 企业微信客户联系外部联系人API 完整开发指南下一篇RimSort CLI 参考使用 build-db 命令无头构建 Steam Workshop 数据库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考