【开源】写好 loop让 agent 夜里无人值守地推进多仓项目loop-skill摘要多仓 vibe coding 时你是不是还在每轮手动 prompt、盯着 CLI 跑完再拆下一批任务关机后进度丢、多 agent 各干各的、不知道哪仓卡住了本文介绍开源仓库loop-skill欢迎Star ⭐用SKILL.md编排主控协议、core/轻量 Python 运行时 本地 Web 看板把书面推进计划变成计划驱动、无人值守的多 agent 闭环——按发现 → 规划 → 执行 → 验收 → 迭代自动派发 Claude Code / Codex / OpenCode / Gemini CLI / Trae CLI任务清空后自动再规划下一阶段会话可恢复、关机不丢上下文。适用于Cursor、Claude Code、Codex CLI等支持 Agent Skills 的环境。一、你是不是也卡在这些问题上用 AI 写代码的同学长任务里常遇到文档、设计、代码都在仓库里但没人系统拆成可执行任务全靠聊天里即兴 prompt开了Claude Code / Codex CLI却要人守着跑完一条再催下一条夜里没法「走开让它自己推进」多个子仓库并行开发不知道哪仓在跑、哪条blocked、今晚推进了多少聊完关 IDE进度没落地第二天重来上下文扯皮、不知道昨晚跑到哪试过绑 GitHub Issue 的重型编排器配置重、和「Markdown 推进计划」工作流不对路想让 agent自己决定下一轮做什么又怕它乱改、没有验收标准、没有留痕。纯靠大模型「帮我一口气做完这个项目」往往结构飘、和仓库事实对不齐、无法后台常驻。更稳的做法是把发现 → 规划 → 执行 → 验收 → 迭代写成固定 loop主控 agent 写计划、运行时派发 CLI、看板盯进度——这正是loop engineeringAgent Skills擅长的事。从「每轮 prompt」到 loop engineering2026 年 6 月Boris ChernyAnthropicClaude Code 负责人在 Acquired 播客里提出了一种转变「我已经不 prompt Claude 了。我写 loop让 loop 去 prompt Claude、决定做什么。我的工作是写 loop。」社区把这类做法称为loop engineeringAddy Osmani、mer.vin 等整理开发者从「对话者」变成循环设计者——定义发现、规划、执行、验收、迭代的规则让 agent 在规则内自驱运转而不是你每五分钟敲一次「继续」。loop-skill就是把这套思想做成可安装、可跑的技能包不是又一个绑死 GitHub Issue 的重型框架而是SKILL.md 轻量 Python 运行时 本地看板放进 Cursor / Claude Code 就能用。二、这个技能是什么loop-skill是一个完整的Agent Skill 仓库Python 运行时组成部分作用SKILL.md触发词、主控协议、五阶段顺序、禁止项不让用户手写loop.json等references/计划生成、角色分工、政策引擎、planner 契约、loop 方法论、CLI 命令表providers/Claude / Codex / OpenCode / Gemini / Trae 等可插拔 CLI 适配规格core/配置、状态、派发、循环、端口标准库为主可选 PyYAMLdashboard/本地实时Web 看板多仓、多角色头像、blocked 高亮examples/工作区配置示例便于本地跑通workspace/运行产物状态、日志、会话、派发归档gitignore支持恢复整体链路可以概括成发现多仓 → 主控写推进计划 → loop 后台派发 CLI 执行与验收 → 任务清空自动再规划 → 本地看板实时盯进度无轮数上限直至 planner 判定无有价值下一步。与客户端无关把loop-skill/目录放进任何能读SKILL.md并执行 shell 的主机 agentClaude Code、Cursor、Codex CLI、Gemini CLI、OpenCode……即可。主机 agent 是指挥者被派发的 CLI 是执行者 / 再规划者。设计目标就一句话你只说话主控干活——推进计划由主控通读仓库后写入各仓docs/loop-plan.md你无需手写loop.yaml也不绑定固定需求文件名。使用效果本地看板多仓卡片、任务状态、角色头像与统计三、核心能力一览能力说明多仓发现discover/scan登记子仓库列出 Markdown 文档清单供主控通读推进计划主控写入各仓docs/loop-plan.md五列ID / 任务 / 验收 / 角色 / 状态兼容docs/推进计划.md等ingest会合并任务表无人值守 loopup后台常驻按间隔轮询 → 执行 → 验收verify_mode→ 继续派发自动再规划某仓 pending / running全部清空后同一 CLI 担任 planner追加下一阶段并ingest默认开启多仓并行默认每仓同时各跑 1 个 CLIfleet_parallel_max0看板先于loop 启动政策引擎references/decisions-guide.md提前写死歧义答案减少 agent 反问卡住多角色任务推荐architect/coder/verifier/reviewer混排禁止写worker会回落为 coderblocked 自愈受阻任务交 planner 补 decision / 拆细自动重试至多 2 次仍卡则看板高亮需人工会话持久workspace/state/存进度与 sessions关机后「继续 loop-skill」可恢复可插拔 Providerdoctor检测本机可用 CLIWindows npm 全局.cmdshim 已适配移除编排remove-plan二次确认只删工作区状态不删开发仓库及其docs/loop-plan.md零重跑已完成任务re-ingest 时保留已完成任务的status/session_id不会把验收过的任务再跑一遍和典型多 agent 编排器有何不同维度典型编排器loop-skill形态npm 包 / 重型框架可移植SKILL.md 轻量 Python 运行时任务来源GitHub Issue / PR书面推进计划docs/loop-plan.md等歧义处理agent 反问、易卡住decisions-guide政策引擎提前写死答案验收CI 全绿verify_mode默认dev-first可按仓覆盖客户端单一产品任意支持 Skill 的 agentProvider单一 agent可插拔 CLI 适配层providers/规划闭环人工反复拆任务首轮主控写计划 之后自动再规划默认开启多仓执行常串行或单仓默认并行每仓各跑一个 CLI看板桌面应用或 SaaS本地实时 Web读workspace/state/四、五阶段循环开环规划 闭环自驱发现discover / scan → 规划主控写 docs/loop-plan.md之后由 planner 自动追加 → 执行loop 派发 CLI 到业务仓改代码 → 验收verify_modedev-first / tests / strict → 迭代任务清空 → 自动再规划 → ingest → 继续首轮规划是「开环」主控 agent 扫描仓库内全部相关 MarkdownREADME、docs 等理解需求后写入推进计划。任务表 ID 用P1-01格式推荐五列| ID | 任务 | 验收 | 角色 | 状态 |。之后是「闭环」loop 后台常驻按--interval轮询派发。某仓任务全部完成时loop 自动把default_providerCLI 当作planner通读仓库与进度把下一阶段任务追加进docs/loop-plan.md再ingest并继续派发。不设轮数上限仅当某轮再规划未新增任何任务planner 判定项目已达成、无有价值下一步时该仓停止再规划。手动关闭自动再规划python -m core.cli loop --no-auto-replan或up --no-auto-replan。详见references/plan-generation.md与references/planner-contract.md。自驱闭环全景便于对照看板用户一句话启动 │ ▼ 主控discover → scan → 各仓写 docs/loop-plan.md → ingest → up │ ▼ loop 后台各仓并行派发 CLI │ ├── 单任务执行 → 验收 → 更新 state ├── blocked交 planner 拆细 / 补 decision → 自动重试≤2 次 └── 某仓全部完成→ planner 追加下一阶段 → ingest → 继续 │ ▼ 某轮再规划无新任务 → 该仓停止你看板验收、合并 PR五、适合谁用多仓 vibe coding的开发者希望夜里无人值守持续推进早上打开看板验收昨晚成果已有 Claude Code / Codex 等 CLI想计划驱动而非每轮手工 prompt玩Cursor Agent Skills、Claude Code的同学想要一个领域完整、可 fork 改造的「后台 loop」样例认同loop engineering愿意把精力放在设计循环与验收标准而不是盯着聊天窗口需要本地看板盯多 agent 进度、且希望会话可恢复的小团队。不太适合只问语法的一次性短对话强依赖 GitHub Issue 闭环且不愿维护 Markdown 计划的团队期望完全零配置、不写任何验收标准。重要说明loop 派发的是coding-agent CLI会在业务仓自动改代码。请在隔离分支 / worktree 中使用并自行审查合并结果。本技能不构成任何产品官方支持承诺也不替代你对代码质量的最终把关。六、怎么用对最终用户极简单配置好技能路径后在对话里用自然语言即可。建议同时说明项目根目录路径、希望用的 CLIclaude / codex 等减少主控猜测。常用场景与提示语场景你可以这样说首次启动「用 loop-skill 推进D:/my-vibe-project下的项目Claude 执行后台常驻。」只看进度「打开 loop-skill 看板。」 / 「推进看板地址是多少」暂停后台「停掉 loop-skill。」 / 「down 掉 loop。」关机后继续「继续 loop-skill恢复后台 loop。」计划跑完等下一轮默认无需操作——loop 会自动再规划要改方向可说「重新扫描各仓、更新推进计划并继续跑。」改了设计要更新计划「我更新了 xxx 的需求请重新扫描各仓、更新推进计划并 ingest再继续跑。」新增子仓库「某目录下新加了 xxx 项目纳入 loop-skill。」从看板移除某仓编排「从 loop-skill 工作区移除 xxx 的推进计划不删开发仓库。」需二次确认任务 blocked默认 loop 交 planner 处理仍卡可看板高亮后说「看板里 xxx 有 blocked 任务请处理并继续。」关闭自动再规划「loop-skill 关闭自动再规划跑完当前计划就停。」换执行 CLI「loop-skill 改用 Codex 执行。」主控会按SKILL.md在同一轮内完成discover→scan→ 为每个子仓写docs/loop-plan.md→ingest→up --interval 300并回报看板 URL默认http://127.0.0.1:8765/。up成功后禁止再反问「是否执行某任务」——loop 会自动派发。推进计划示例主控自动生成| ID | 任务 | 验收 | 角色 | 状态 | |----|------|------|------|------| | P1-01 | 实现用户登录 API | pytest tests/test_auth.py 通过 | coder | pending | | P1-02 | 评审登录模块安全边界 | 无硬编码密钥、有 rate limit | reviewer | pending | | P1-03 | 补充架构说明与模块边界 | docs/architecture.md 更新 | architect | pending |IDP1-01可追踪编号验收写清怎样算完成供verify_mode与 verifier 角色使用状态loop 运行后更新为 running / done / blocked 等你不需要事先准备好这份文件——首次启动时主控会通读仓库自动生成你改设计后说一句「重新扫描并更新推进计划」即可刷新。主控协议要点SKILL.md约定禁止让用户手写loop.json/loop.yaml或逐步确认禁止主控代替 CLI 在业务仓写实现除非用户明确只要主控、不用 loop禁止用同步dispatch对每仓「试跑」——4 仓会阻塞 4 次长等待应ingest→up后台跑若ingest后任务数为 0up会失败——主控应回到写推进计划勿问用户七、安装与环境环境要求Python3.10PATH中至少一个 coding-agent CLI现代浏览器看板依赖核心运行时零第三方依赖纯标准库。pip install -r requirements.txt仅为可选loop.yaml支持PyYAML若用等价loop.json可不装任何东西。gitclone https://github.com/handsomestWei/loop-skill.gitcdloop-skill python-mcore.cli doctor claude# 检查 PATH 里有哪些 CLI 可用pipinstall-rrequirements.txt# 可选Claude Code示例mkdir-p.claude/skillsgitclone https://github.com/handsomestWei/loop-skill.git .claude/skills/loop-skillCursor将完整仓库放到 Cursor 约定的skills路径重启后在Settings → Rules中确认技能已发现路径与说明以官方文档及仓库SKILL.md为准。触发语参考写在SKILL.mdfront matter「用 loop-skill 推进某目录下的项目」「后台常驻 loop」「自动推进计划」等。八、支持的 Provider可插拔 CLIproviders/目录定义各 CLI 的适配规格运行时通过doctor检测本机可用项Provider典型 CLI说明ClaudeclaudeClaude Code CLICodexcodexOpenAI Codex CLIOpenCodeopencodeOpenCode agentGeminigeminiGemini CLITraetrae-cliTrae CLIdoctor输出中至少一个[ok]即视为有可用的执行 CLI看输出末尾「可用 provider」行。限制并发--fleet-parallel-max N单仓轮询--serial --fleet-parallel-max 1。九、验收模式verify_mode不同仓库可覆盖默认验收策略写在loop.yaml/loop.json或按仓覆盖模式含义dev-first默认偏开发阶段快速验收tests强调测试通过strict更严格验收Worker 输出契约见references/worker-contract.md。十、角色分工与状态落盘角色谁来做改什么你开发者说意图、审看板、改业务仓设计 / 需求 / 推进计划主控Cursor、Claude Code、Codex CLI 等loop-skill/、workspace/、各仓docs/loop-plan.md、启停 loop执行者claude/codex/opencode等loop 自动派发在业务仓写代码实现再规划者默认同default_providerCLI某仓任务全部完成后自动追加下一阶段计划文件 / 目录内容loop.json多仓登记与任务定义自动生成勿提交gitworkspace/state/repo.json任务进度、sessions、活动流workspace/runtime.json看板端口、后台 PIDworkspace/logs/supervisor/看板与 loop 日志workspace/prompts/、results/派发 prompt 与结果归档看板与 loop 都读这些文件——IDE 聊天窗口关了后台 loop 仍在跑机器重启后说「继续 loop-skill」即可接上。从工作区移除某仓编排用户说「移除 xxx 的推进计划」时主控须二次确认并明确会删workspace/下该仓 state、prompts、results、logs以及loop.json登记项不会删磁盘上的开发仓库及其docs/loop-plan.mdpython-mcore.cli remove-planrepo# 获取确认令牌python-mcore.cli remove-planrepo--confirmtoken看板卡片「移除」按钮同样两步确认。十一、本地看板能看什么up启动后访问http://127.0.0.1:8765/端口以workspace/runtime.json为准多仓库卡片pending / running / done /blocked统计任务列表与最近活动流多角色动态界面与任务「角色」列对应architect / coder / verifier / reviewer卡片上可发起「移除编排」二次确认适合一边喝咖啡一边扫一眼哪仓在跑、哪条卡住了、今晚 loop 又推进了多少。十二、仓库目录与文档索引loop-skill/ ├── SKILL.md # 技能入口何时用、主控协议、一句话启动 ├── references/ # 方法论、政策、契约 │ ├── plan-generation.md # 主控 planner 协议必读 │ ├── role-guide.md # architect / coder / verifier / reviewer │ ├── decisions-guide.md # 政策引擎 │ ├── loop-engineering.md # 五阶段 六原语 │ ├── planner-contract.md # 再规划者契约 │ ├── worker-contract.md # CLI worker 输出与验收 │ └── cli-commands.md # 完整 CLI 分类表 ├── providers/ # 各 CLI 适配规格 ├── core/ # 配置、状态、派发、循环、端口 ├── dashboard/ # 本地 Web 看板 ├── examples/ # 工作区配置示例 └── workspace/ # 全部运行产物gitignore手动调试时常用子命令命令用途doctor检测可用 Providerdiscover/scan/ingest多仓登记、文档清单、导入任务表up/down启停后台看板 loopstatus查看运行状态remove-plan从工作区移除某仓编排二次确认loop/dispatch调试派发日常由up自动完成勿用 dispatch 试跑多仓十三、和 Superpowers 等技能怎么搭配类型代表侧重会话内流程技能Superpowers单次任务内的设计、TDD、评审门禁后台推进 looploop-skill跨会话、跨仓库、无人值守派发 CLI二者可叠加主控用 Superpowers 规范「动工前设计、先测后写、完工前核验」loop-skill负责夜里后台按docs/loop-plan.md持续派发 CLI。一个管单次会话质量一个管长时间推进节奏。十四、常见问题Q一定要会 Python 吗日常不用记命令自然语言驱动主控即可只有调试、脚本集成时才python -m core.cli。Q自动再规划会不会乱加任务planner 受planner-contract与仓库现状约束若某轮未新增任务即停止。可--no-auto-replan跑完当前计划就停。Q主控会代替 CLI 写代码吗SKILL.md禁止主控在业务仓写实现除非用户明确只要主控实现由派发的 CLI 完成。Q和 GitHub Actions / Issue 驱动的 bot 有什么区别loop-skill 任务来自你仓库里的 Markdown 推进计划不绑 Issue 生命周期适合个人/小团队 vibe coding而不是企业级 CI 门禁。Qblocked 了怎么办默认 loop 自动交给 planner 补 decision、拆细任务并重试至多 2 次。看板会高亮仍须人工介入的项你说一句「处理 blocked 并继续」即可。Q核心依赖重吗运行时零第三方依赖可选pip install仅为loop.yaml。十五、链接汇总资源说明GitHub 仓库https://github.com/handsomestWei/loop-skill技能入口仓库根目录SKILL.md主控 planner 协议references/plan-generation.mdCLI 命令表references/cli-commands.md配置示例examples/loop engineering 背景mer.vin 整理文Agent Skills 规范https://agentskills.io如果这篇文章对你有用欢迎去 GitHub点 Star ⭐支持一下——Star 能帮助更多做 agent 编排的朋友发现这个项目。也欢迎Fork 试用、提Issue反馈场景多仓并行、blocked 自愈、新 Provider或贡献providers/适配与文档改进。标签AIAI编程AgentSkillClaude CodeCursorCodexloop engineering多智能体无人值守开源