loop-engineering 发布后激活清单（Activation Checklist）：第 1–4 周上线执行手册

人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务【免费下载链接】loop-engineeringPractical patterns, starters CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.项目地址https://gitcode.com/gh_mirrors/lo/loop-engineering点击查看免费下载本清单是 loop-engineering 仓库在发布activation PR合并之后、面向维护者的第 1–4 周上线执行手册从打 npm tag、触发 trusted publishing 流水线到录制「空仓库 → 首个 STATE.md」演示视频再到 arXiv 论文话题、Show HN、术语表与 fork 外联四路分发。读完你可以照单执行完整的发布收尾与冷启动流程并了解每一步背后的源码实现.github/workflows/release-loop.yml、tools/loop-init/src/cli.ts、tools/loop-audit/src/auditor.ts。适用前提本清单描述的是仓库作者在激活 PR 合并后的发布动作。仓库是只读的你无法修改它但可以 clone 后自行构建、运行与验证其中所有命令。1. 发布 npm只在 tag 上发布绝不在笔记本上npm publish激活清单的第一步是给三个包打 tag 并推送让 CI 完成发布。tag 命名规则与仓库中的 release workflow 完全对应release-loop.yml监听loop-v*release-loop-init.yml监听loop-init-v*release-loop-audit.yml监听loop-audit-v*git tag loop-v0.2.0 git tag loop-init-v1.7.0 git tag loop-audit-v1.9.0 git push origin loop-v0.2.0 loop-init-v1.7.0 loop-audit-v1.9.01.1 Trusted publishingOIDC 代替本地凭据发布由.github/workflows/release-loop.yml及其 siblings自动完成。该 workflow 的关键设计触发条件push到loop-v*tag或workflow_dispatch手动指定 tagtag输入框。权限最小化permissions.contents: read、permissions.id-token: write——只有读仓库内容和签发 OIDC token 的权限。Node 22 npm registry使用actions/setup-nodev7registry-url指向https://registry.npmjs.org并缓存tools/loop/package-lock.json。签名链安装最新 npm 与sigstore发布时携带--provenance。发布前全量构建先npm ci npm run build构建readiness-core、loop-audit、loop-sync、loop-init、loop-cost五个兄弟工具再构建tools/loop本身并跑npm test全部通过才发布。workflow 中有一行注释很关键# OIDC trusted publishing — do not set NODE_AUTH_TOKEN (it overrides OIDC)即本地npm whoami未授权时不要手动发布——因为发布凭据由 CI 的 OIDC 身份提供设置NODE_AUTH_TOKEN反而会覆盖 OIDC 路径。这也是清单中「do notnpm publishfrom a laptop」的底层原因。1.2 为什么先 tag 再 Show HN后续的 Show HN 步骤被明确要求「after tags are live sonpxis 0.2.0」——即确保读者复制npx cobusgreyling/loop ...时拉取到的是已发布版本而不是还在 CI 构建中的旧版。所以顺序是tag → 发布 → 验证 npx 可用 → 再对外分发。2. 录制「空仓库 → 首个 STATE.md」视频发布后需要一段 8–10 分钟的演示视频脚本见 docs/distribution/empty-to-state-video.md本地彩排命令为bash scripts/empty-to-state-demo.sh视频上线后把 README 主图区的 hero GIF 换成视频文件。2.1 镜头清单与关键口径脚本共 10 个镜头核心叙事线是「一个命令、一个只读循环、一个 STATE.md」0:00 标题卡 ——「Empty repo → first STATE.md. Report only.」0:05mkdir demo cd demo git init ls空目录0:20npx cobusgreyling/loop init . --pattern daily-triage --tool claude停在 Loop Ready 分数上旁白强调“This score is files on disk. It is not permission to auto-fix.”1:30npx cobusgreyling/loop doctor .指向 Top 3 建议。2:30sed -n 1,16p STATE.md——运行前 Last run 为空。3:30 第一次循环/loop 1d $loop-triage — update STATE.md. Report-only week one.6:00 运行后 STATE.md——High Priority 出现真实条目Last run 变为当天的 ISO 时间戳。7:00git add STATE.md git commit -m chore(loop): first L1 daily triage——强调「这个提交才是 Loop Ready 计入的 activity」。8:00 再次doctor——activity 发现正常。8:45 结尾——“Do not turn on L2 this week. Read the file tomorrow.”注意口播口径Loop Ready 分数只反映磁盘上的文件与近期活动不等于自动修复的许可第一周保持 report-only。2.2 无法录制时的降级方案bash scripts/empty-to-state-demo.sh可以直接在终端跑出整条路径临时目录 →git init→loop-init脚手架 → 首次loop-audit文件分尚无运行记录→ 展示 STATE.md → 用 Python 脚本模拟一次 L1 运行写入时间戳 → commit → 再次loop-audit出现 dated run。脚本本身scripts/empty-to-state-demo.sh要求先构建tools/loop-init/dist/cli.js与tools/loop-audit/dist/cli.js否则会报错退出结束时trap cleanup EXIT自动删除临时目录。把这段真实终端输出贴成 gist 挂在 README 上比再做一个分数 GIF 更有说服力。3. 四路分发arXiv 话题、Show HN、术语表外联、fork 外联激活清单给出了四份现成文案对应四个不同的分发渠道文档渠道核心诉求arxiv-paper-thread.mdX LinkedIn借 217 个真实 loop 的实证讲「配置进了 git、运行时状态没进 git」show-hn.mdHacker News22 次工作日 triage 的诚实复盘标题即论点glossary-outreach.md五个术语表/清单类站点逐个私信请求加一条「further reading」链接fork-outreach.md20 个最近 fork一对一邀请真正跑过 loop 的人来 adopters 列表加一行3.1 arXiv 话题实证数据支撑的立场arxiv-paper-thread.md 的核心论据引用自论文摘要仓库作为社区参考仓库被论文作者审阅过研究者扫描了 36,710 个仓库确认217 个自主 agent loop几乎没有一个提交STATE.md——「The config is in git. The runtime state is not.」这 217 个 loop 大多是事件触发的 PR review下一个 PR 就是下一次运行无需持久化定时触发的多是 issue triageissue tracker 本身就承载 backlog。由此得出仓库自身的产品决策如果 GitHub 已经是队列就不要再造第二个队列。仓库据此落地了thin-loop模式并把「14 天前的 Last run」降级为 stale。3.2 Show HN用 run log 打脸分数show-hn.md 要求必须在激活 PR 合入main、last-run badge 生效之后才提交。标题直接点破主题「22 weekday agent-triage runs on our own repo – what the score hid」。正文数据来自 stories/thirty-weekday-runs.md 的实测 run log22 次工作日记录log 30 天裁剪22/22 全部report-only0 次升级token 字段恒为 52,000——这是 workflow 写死的占位值不是测量值STATE.md last run 停在 2026-08-27。这篇故事是「诚实复盘」的模板分数全程 100/L3但 run log 显示循环从未离开 L1。由此推出的四项仓库改动README 一屏化、默认--tool claude、thin-loop starter、Loop Ready 把 14 天前的 Last run 视为非活动与激活清单末尾「Already done in-repo」完全呼应。3.3 术语表外联与 fork 外联术语表外联五家站点Data Science Dojo、Sofokus、V12 Labs、DEV.co、Codingscape都已撰文讨论 loop engineering 但未链接参考仓库。逐一发简短邮件请求「citation / further reading / try it」级别的链接即可默认命令统一为npx cobusgreyling/loop init . --pattern daily-triage --tool claude npx cobusgreyling/loop doctor .fork 外联目标是为 adopters 列表积累 5 个非本仓库的真实使用行禁止批量 issue。用gh api按最新排序拉取 20 个 fork优先选择pushed_at晚于 fork 时间说明真的动了东西的仓库跳过空 forkgh api repos/cobusgreyling/loop-engineering/forks?sortnewestper_page20 \ --jq .[] | \(.pushed_at)\t\(.full_name)\t\(.html_url)消息模板强调「即使只是 L1 report-only、即使你删掉了 STATE.md 也行失败案例优先」并且「fork 了但从没跑过的可以忽略」。4. 仓库侧已完成的工作activation PR 内清单末尾列出的仓库内改动是后续所有分发动作的事实基础README 精简为一屏默认--tool claude——这也是loop-initCLI 的默认值源码见 tools/loop-init/src/cli.ts--pattern/-p与--tool/-t两个参数解析。#522 的答复落在 docs/refactor.md 与 README.zh-CN.md 两份文档。thin-loop starter 与 last-run badgethin-loop模式只给一个 GitHub Action、一个 job summary不需要 STATE.md详见 patterns/thin-loop.mdlast-run badge 由 scripts/update-last-run-badge.mjs 读取 STATE.md 的Last run:写入 docs/last-run.json 供 badge 端点使用。Loop Ready 权重改为「新鲜运行」优先源码层面tools/loop-audit/src/auditor.ts 定义ACTIVITY_MAX_AGE_MS 14 * 24 * 60 * 60 * 100014 天审计时正则匹配Last run:时间戳并通过git log --since14.days -- STATE.md loop-run-log.md ...检查近期 git 活动超过 14 天没有运行记录时给出 warning「files on disk are not loop activity」。Claude Code 插件元数据、诚实的 22 次运行故事stories/thirty-weekday-runs.md。4.1 thin-loop 的设计动机thin-loop 是本次激活动作里最值得单独理解的部分论文实证显示大多数真实 loop 本来就不提交 STATE.md因此仓库主动提供「不假装有状态文件」的模式——PR review / issue 快照就是工作本身GitHub 的 issue tracker 和 Actions job summary 就是状态。第一周保持 L1workflow 只写$GITHUB_STEP_SUMMARY且只在事件线程上还没有!-- thin-loop --标记时才评论一次避免刷屏。5. 执行顺序总结可直接照做合并激活 PR本清单随 PR 合入。git tag三个版本并git push origin→ 触发 trusted publishing 流水线等 npm 上npx cobusgreyling/loop可用。bash scripts/empty-to-state-demo.sh彩排 → 录制 8–10 分钟视频 → 替换 README hero GIF。tags 生效后发 arXiv 话题X LinkedIn→ 提交 Show HN → 术语表五站点逐个外联 → fork 逐个私信。用 docs/adopters.md 承接跑过 loop 的真实用户48 小时内评审 adopters 行。这套清单的核心纪律可以概括为一句话先让npx指向真实发布再让对外叙事全部建立在 run log 与新鲜运行之上而不是分数与模板文件之上。赞分享人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务【免费下载链接】loop-engineeringPractical patterns, starters CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.项目地址https://gitcode.com/gh_mirrors/lo/loop-engineering点击查看免费下载相关推荐ILC核心架构深度解析为什么它是微前端的最佳选择ILC核心架构深度解析为什么它是微前端的最佳选择 在当今快速发展的Web开发领域微前端架构已成为构建大型企业级应用的主流趋势。 ILCIsomorphic人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务Flipper Zero BadUSB 实操3 步在虚拟机里完成第一次安全测试侦察Flipper Zero BadUSB 实操3 步在虚拟机里完成第一次安全测试侦察 把 USB C 插进虚拟机两秒后客系统光标自己开始打字——这一刻你会明白人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务在 Claude Code 中以插件方式安装 loop-engineering 技能marketplace 配置、技能清单与第一周报告制循环实战在 Claude Code 中以插件方式安装 loop engineering 技能marketplace 配置、技能清单与第一周报告制循环实战 本指南讲解如人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务上一篇2025终极指南Dapper数据库连接池监控与资源优化实战下一篇彻底解决Dapper日期时间处理难题时区转换与格式优化全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考