SuperAPI AI 工具集

agent-dev-workflow

智能体与模型

查看项目

更新于 10-15 22:40

技能介绍

用途:该技能在项目中搭建一套 bin/ 任务运行器,让同一项目的多个副本在单机上并发运行——每个 git worktree 一个副本,各自拥有数据库与端口,共用同一个 Postgres 容器。它为智能体编排器(如 Conductor 等)提供 setup/run/cleanup 契约,同时让测试跑在专用库上,避免清空开发数据。

主要能力:身份由 worktree 路径派生,主检出用规范库名与默认端口,每个 agent worktree 用 app_<路径哈希> 库并取各端口段的下一个空闲端口,测试强制使用 app_test。共享 Postgres 容器按名称复用、与路径无关。每个派生值都支持环境变量覆盖(如 APP_DATABASE、APP_PG_PORT、PORT)。区分固定可复制的部分(worktree 感知的库名、共享容器管理、端口挑选、dev 会话状态机、pid 起始时间校验、bin/gc 证明结构)与需按项目配置的部分(前缀、PG 用户/镜像、发布地址、基础端口段、Postgres 大版本等)。辅助服务按机器共享而非按 worktree 复制,可用 compose 只跑这些服务。工作树建议放在 .claude/worktrees/ 下,由 bin/gc 在证明已合并后清理;bin/stop 是唯一的机器级脚本,在证明容器空闲后才停止它。该技能与 ci-quality-gates 在测试脚本这一处衔接,CI 定义 gate,本技能让本地测试不覆盖开发数据。

使用方式:先阅读 references 下相关文件,将参考脚本复制进项目 bin/,改前缀并填 _common.sh 常量,选择单服务或全栈 dev 变体,接入测试隔离预加载,chmod +x,如存在 docker-compose.yml 则移除其中的 Postgres 与应用服务,更新环境示例与智能体文档,并端到端验证(干净检出运行 bin/setup、两个 worktree 的 bin/dev 落在不同端口、同一 worktree 二次运行应 attach、bin/gc --dry-run 判定合理、bin/cleanup 不影响主库)。具体命令与脚本内容见原始资料,本次未提供完整代码示例。

适用场景:有 Postgres 且需要并发 worktree 开发、编排器 setup/run/cleanup 钩子、测试隔离或替代仅用于本地 Postgres 的 docker-compose 的项目。

限制:没有数据库时大部分不适用;没有并发需求且测试已用独立库时收益小;gRPC 端口不能用 curl 检查,需用普通 TCP 就绪探测;发布地址在容器创建后冻结;bin/stop 不会删除容器或卷,也不阻止并发 setup 重新拉起容器;在 .claude/worktrees/ 之外创建的工作树不会被清扫。