peaks-loop weekly downloads statistics

<div align="center">

peaks-loop

你说话,它替你跑完一整条工程流水线 —— 不止写代码,跑两次就沉淀成本地战术。

English · 简体中文

</div> <p align="center"> <img src="./assets/readme/hero.svg" alt="peaks-loop 4.0.3 — Loop Engineering, Engineered" width="92%"/> </p>

---

它是什么

peaks-loop 是装在你已经在用的 AI 编程工具(Claude Code / Z Code)上的一个编排层。你在对话框里发一条斜杠命令,它把整条工序替你跑完:拆工序 → 一道门一道门跑 → 坏在哪道停在哪道。

你只要做两件事:说一句话,或者在一个选项里挑一个。

• 它不是新的 AI CLI。 不抢你的 shell、不抢你的 prompt、不抢你的 IDE,也不替换 IDE 里任何一个原生入口。
• 你不用背 CLI、不用手写 manifest、不用手填表单。 所有 CLI 命令对外隐藏、对 LLM 开放;命令由它替你跑,你只说话。
• 它不替你拍板。 影响你资产的决策会拿来问你;其余的它自己跑。

---

30 秒上手

npm i -g peaks-loop

npm 11+ 请带一个 flag:安装时 npm 会对"未经 allowlist 覆盖"的 install 脚本打一条 install-scripts 警告。当前版本(npm 11.19)仍然会执行这些脚本,所以装完就能用;但 npm 已明说这个默认值即将翻成"默认不执行"。为了不在那一天静默装到一个"有 CLI、没有 skills"的状态,请写全:

npm i -g --allow-scripts=peaks-loop peaks-loop

装好后如果怀疑 skills 没落上,目前没有一条 CLI 命令报告这个状态(peaks skill search 查的是包内技能池,与 IDE 目录里装了没装无关),所以只能看目录本身:

ls ~/.claude/skills | grep '^peaks-' | head    # 或你实际在用的 IDE 目录

空目录 = skills 没装上(CLI 本身仍可用)。这个"报告不出自己装了没装"的缺口记在 .peaks/docs/backlog.md §2.52a。

装好之后,在你已经用的 Claude Code 或 Z Code 对话框里发一条显式命令(必须以斜杠开头,才会触发 peaks-loop):

/peaks-code 帮我熟悉下当前的项目

剩下的就交给 peaks-loop —— 它会按这条命令的语义判断该走哪一域,用对应的编排器拆工序,一道门一道门跑,坏在哪道停在哪道,中间不会扔半截给你。

其他常用的显式命令:

/peaks-content                 帮我把今天这篇推文写完发出
/peaks-doctor                  帮我体检一下这个仓库
/peaks-issue-fix-orchestrator  帮我把 upstream 的 30 个 open issue 修一批
/peaks-sop                     帮我把团队的发布流程沉淀成 SOP
/peaks-solo                    这套打法以后还会用,沉淀成本地战术

_{📦 其他 AI 编程工具适配中,欢迎共建 → GitHub Issues 提适配请求 / PR。}

不需要记 CLI、不需要写 manifest、不需要切到第二个终端。斜杠命令一发,后面的活它替你跑完。

装这个包会多下载多少? 这一版把变异测试引擎(@stryker-mutator/core + @stryker-mutator/vitest-runner)作为运行时依赖带上了 —— 消费者的安装会多出 stryker 引擎闭包 约 2.66 MB(9 个包)。vitest 家族那 5.30 MB 只在你的机器上还没有 vitest 时才会被自动装上, 而要跑 peaks mut 的项目必然已经有 vitest。一句话:你装 peaks-loop 多下载了约 2.7 MB。

---

装上以后，文件放在哪

npm i -g 之后,三类资产(skills / agents / output-styles)的实体只存一份,放在你自己 home 下的 ~/.peaks/{skills,agents,output-styles};每个 IDE 目录里(~/.claude/…、~/.trae/… 等)的条目都是指向它的链接 (目录用 junction,单个 .md 文件用符号链接)。所以升级 peaks-loop 时链接目标不变、不需要重建。

两件会直接影响你的事:

• 受管入口会在升级时被覆盖。 由 peaks-loop 装进去的入口(比如 ~/.claude/agents/karpathy-reviewer.md)旁边有一份 .peaks-managed 边车标记归属,升级时内容会被更新。想换成你自己的版本,删掉那份额边车即可 —— 没有标记的入口 一律视为你自己建的,永不被替换、也永不被删除。
• 有些 Windows 机器上会退化成实体副本。 没有开发者模式、也不是管理员时,建不出文件符号链接(目录用的 junction 不受影响),安装器会写实体副本并在 stderr 明说 installed as REAL COPIES because this host refused a symlink。 内容照样跟着升级走。

真源根可用环境变量 PEAKS_HOME 重定向。完整的模型、从 4.1.1 升级时会发生什么、怎么验证与回退 → .peaks/docs/canonical-store.md。

---

它能为你做什么

代码、内容、项目健康、issue 修复、自定义工作流 —— 每条域都有专门编排器,按"门禁不通过就停"的纪律一条一条跑。 你要做的只是挑一条命令发出去:

域	你发这条命令	它会做什么
💻 代码域 (code-domain) only	/peaks-code 帮我实现这个功能	PRD → RD → 实现 → QA → UI → 切片,跑完交你拍板
💻 代码域 (code-domain) only	/peaks-code 这个 bug 帮我修一下	复现 → 改 → review → 测试,同日 ship
📝 内容	/peaks-content 帮我把这篇推文写出来再发	草稿 → 编辑 → 调性检查 → 发布 → 归档,中间不跳步
🩺 项目健康	/peaks-doctor 帮我体检一下这个仓库	红线审计 + L3 doctor 检查 + 转 OpenSpec,坏在哪道停在哪道
🐛 批量修 issue	/peaks-issue-fix-orchestrator 帮我把 upstream 的 30 个 open issue 修一批	调研 → 分类 → 参考 PR → 逐个修复 + commit + PR 草稿
📋 自定义工作流	/peaks-sop 帮我把团队的发布流程沉淀成 SOP	自然语言描述 → 自动生成 + 校验 + 注册成可执行的 SOP
🔁 跑过一次再来	/peaks-solo 按上次那样再跑一次	调出你已经沉淀好的战术,自动复跑
🆕 接手陌生仓库	/peaks-code 这是新仓库,先带我过一遍	摸清结构、识别风险点、给一个上手顺序
🧠 沉淀自己的打法	/peaks-solo 这套打法以后还会用,沉淀一下	变成你本地常驻的战术,下次说"跑那只"就行
🧪 开闸审计	/peaks-audit	6 维审计,RD/QA 前的强制入口
✅ 4 维验收	/peaks-final-review	功能/问题/不引入新 bug/不破坏
🔌 IDE 适配	/peaks-ide	hooks + statusline + handle
⏯ 从断点续跑	/peaks-resume	扫最深完成的门,AskUserQuestion
🔬 切片拆解	/peaks-slice-decompose	多 pass + 跨 pass 边 + 仲裁

每一条路,一条斜杠命令就能开跑。

---

为什么大家会选它

• 自然语言即界面 —— 你不学 CLI、不背命令。用一条斜杠命令(比如 /peaks-code xxx) 显式触发到对应编排器,后面说什么都行。LLM 替你跟 peaks-loop 跑命令。
• 门禁真挡事,不是装饰 —— 代码审计、安全扫描、QA 闸口、review 验收默认全开。审计不通过就停,QA 没过就停。
• 跑过的事会变成本地战术(bee) —— 沉淀下来的东西落到你本地的 ~/.peaks/ 池子里,跑两次稳定就自动晋升;跑翻车的会让你重新定义。下次说"跑那只"整套流程自动就位,你那几只战术会跟着你的口味长。
• 搭在你已经用的工具上 —— 不是新发明一个 AI CLI,而是架在 Claude Code 和 Z Code 之上。不抢你的 shell、不抢你的 prompt、不抢你的 IDE。其他工具适配中,欢迎共建。
• 你拍板,它执行 —— 影响资产的决策都给你选;其余的它自己跑。0 学习成本,1 分钟上手。

---

强烈推荐 · 三个项目组合起来用

0 学习成本。 让这几个项目一起用最大的好处,是它们的接口都对齐到"自然语言 + 一个选项":你说一句话,谁替你跑命令、按什么闸门、按什么战术手册,完全不用你记。…