用 loop-engineering 的 Changelog Drafter Opencode Starter 搭建 AI 发布说明生成循环

人工智能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仓库中的starters/changelog-drafter-opencode/为骨架讲解如何在opencode环境中一键搭建「Changelog Drafter」循环让 AI Agent 自动扫描合并的 PR 与提交产出分类清晰、面向用户的发布说明草稿并严格把发布/打 tag/开 PR等动作保留给人工审批。读完本文你将掌握该 starter 的全部文件职责、npx脚手架与手动复制两种接入方式、opencode run的 L1 启动命令以及从 L1仅出草稿升级到 L2提交草稿 PR的安全演进路径。1. 这个 Starter 是什么starters/changelog-drafter-opencode/是 Changelog Drafter 模式的clone-and-run 脚手架复制即用专门面向 opencode 这一 AI 编码工具。它的核心定位一句话可以概括——扫描合并的 PR 和提交产出分类的发布说明release notes草稿。它与同仓库的通用版 starters/changelog-drafter/ 的差异在于工具绑定opencode 版本通过opencode.json定义命名 Agent、通过AGENTS.md承载常驻安全规则并在skills/changelog-scan/下提供单一扫描技能。对应的模式理论、多工具示例与实战周报分别见 patterns/changelog-drafter.md、examples/opencode/changelog-drafter.md 和 stories/changelog-drafter-week-one.md。2. 快速开始两种接入方式方式一npx 一键脚手架推荐在仓库根目录执行npx cobusgreyling/loop-init . --pattern changelog-drafter --tool opencode该命令由 tools/loop-init/ 提供会依据--pattern changelog-drafter与--tool opencode的组合把本 starter 的相关文件技能、Agent 配置、状态模板、LOOP/AGENTS 文档复制到当前项目省去手工拷贝。方式二手动复制想完全掌控每个文件时可逐条手动复制cp -r starters/changelog-drafter-opencode/skills . cp starters/changelog-drafter-opencode/AGENTS.md . cp starters/changelog-drafter-opencode/LOOP.md . cp starters/changelog-drafter-opencode/changelog-drafter-state.md.example changelog-drafter-state.md cp starters/changelog-drafter-opencode/opencode.json.example opencode.json复制完成后可以用仓库自带的审计工具检查循环设计是否达标npx cobusgreyling/loop-audit . --suggest3. 文件清单每个文件的职责文件用途changelog-drafter-state.md.example状态骨架记录上次扫描的 tag、草稿状态、人工反馈skills/changelog-scan/SKILL.md合并扫描与分类技能AGENTS.md常驻安全规则always-on safety rulesLOOP.md节奏cadence、门禁gates、预算budgetopencode.json.example命名 Agent 定义这五类文件构成了循环的四要素技能负责怎么做状态负责做到哪了常驻规则负责什么不能做节奏与预算负责多久做一次、花多少成本。4. 启动第一轮循环L1 报告 草稿脚手架就绪后用下面的命令启动第一轮第 1 周处于 L1只出报告与草稿opencode run \ Run skills/changelog-scan/SKILL.md. Scan merges since last tag (or last 7 days). Produce categorized draft in RELEASE_NOTES_DRAFT.md. Update state. Do not publish or create PRs. \ --title Changelog drafter这段提示词拆解为四个动作读取技能执行skills/changelog-scan/SKILL.md中定义的扫描流程确定窗口扫描自上次 tag 以来的合并记录若没有 tag则回退到最近 7 天产出草稿把结果分类写入仓库根目录的RELEASE_NOTES_DRAFT.md仓库本身即以此文件为循环产物示例见 RELEASE_NOTES_DRAFT.md更新状态把本次扫描窗口与草稿状态写回changelog-drafter-state.md。注意提示词末尾的硬约束Do not publish or create PRs——这是 L1 阶段不可逾越的红线。若希望按日定时执行推荐在合并稳定后的晚间运行可配合 cron0 3 * * * cd /repo opencode run Scan merges since last tag, draft categorized release notes, update state. Human review only.对应的节奏约定记录在 starters/changelog-drafter-opencode/LOOP.md1d每日或 release 准备期触发L1 阶段保持仅草稿状态。5. 扫描技能拆解changelog-scan/SKILL.md技能文件 skills/changelog-scan/SKILL.md 是循环的执行核心其 frontmatter 声明了name: changelog-scan description: Scan merged PRs and commits since a given reference, extract titles, labels, types, and signals. Produces structured input for release notes drafting. user_invocable: trueuser_invocable: true意味着该技能可被用户或主 Agent 直接调用。5.1 扫描源Scan Sourcesgit log --merges --oneline last-tag..HEAD—— 自上次 tag 以来的合并提交PR labels 与 milestones —— 用于判断变更类型与优先级自上次 tag 以来的提交信息 —— 捕捉未走 PR 的直接提交。5.2 分类Categories草稿按以下六类组织Features新功能Bug fixes缺陷修复Documentation文档Dependencies依赖变更Breaking changes破坏性变更Security安全其中Breaking changes 与 Security 必须显式呈现这是技能规则硬性要求。5.3 输出与规则Output Rules分类草稿写入RELEASE_NOTES_DRAFT.md用扫描窗口更新changelog-drafter-state.md未经人工明确批准绝不发布、绝不打 tagL1 只出草稿不建 PR、不打 tag。6. 命名 Agentopencode.json.exampleopencode.json.example 定义了三个命名 Agent把扫描、实现、验证拆成三个职责边界清晰的执行者6.1changelog-scanprimary 主 Agent{ name: changelog-scan, description: Changelog drafting loop. Reads changelog-drafter-state.md, scans merges, and produces categorized release notes., mode: primary, prompt: Read AGENTS.md, LOOP.md, changelog-drafter-state.md, and skills/changelog-scan/SKILL.md. Scan merges since last tag. Produce categorized draft in RELEASE_NOTES_DRAFT.md. Never publish or tag without human approval., permission: { bash: ask, edit: ask } }作为主 Agent它先读取全部上下文AGENTS.md、LOOP.md、状态文件、技能文件再执行扫描并产出草稿bash与edit均设为ask任何命令执行与文件修改都要征求许可。6.2implementerL2 子 Agent{ name: implementer, description: L2 implementer for creating changelog PRs., mode: subagent, prompt: Run npx cobusgreyling/loop-gate check --action commit --paths changed_files before committing. Commit the approved release notes to a new branch and open a draft PR. Flag breaking changes and security items explicitly in the PR body. Do not merge., permission: { bash: ask, edit: ask } }这是 L2 阶段才启用的实现者提交前必须调用 tools/loop-gate/ 的loop-gate check --action commit做门禁校验然后在新分支提交批准的发布说明并打开draft PR草稿 PR且明确禁止 merge。该命令正是仓库根目录 gate.yaml 所配置门禁规则在 CLI 层的执行入口。6.3verifier只读校验者{ name: verifier, description: Checker agent for draft release notes. APPROVE or REJECT only., mode: subagent, prompt: Review the draft notes for completeness, categorization, and correct date range. Flag missing sections. Do not edit. APPROVE or REJECT., permission: { bash: ask, edit: deny } }校验者只能输出 APPROVE 或 REJECT 两个结论edit权限被设为deny——验证者绝不亲手改稿这保证了草稿者不能给自己的输出打分的验证原则。若不想启用独立 verifier Agent也可用 skills/loop-verifier/SKILL.md 或直接由人工承担 L1 阶段的校验。7. 状态文件changelog-drafter-state.md状态模板 changelog-drafter-state.md.example 定义了循环的记忆骨架# Changelog Drafter State Last run: 2026-06-20 09:00 UTC Last tag scanned: v0.0.0 Draft status: none Human feedback: pending ## Scan Window - From: !-- last tag or date -- - To: !-- current -- - Merges found: 0四个顶层字段的含义Last run上次运行时间用于判断循环是否过期Last tag scanned已扫描到的最后一个 tag下一轮从它开始Draft status当前草稿状态none / ready for review / approved 等Human feedback人工反馈是否已处理是人工门禁闭环的关键。按 patterns/changelog-drafter.md 的约定发布完成后应修剪已发布条目并可追加## Post-Run Critique小节记录遗漏项、误报项、分类错误、重试次数与下一轮的提示词调整建议。每次运行前主 Agent 都必须先读这个状态文件见 AGENTS.md 与 opencode.json 的 prompt确保从上次停下的地方继续。8. 常驻约束AGENTS.md 与 LOOP.md8.1 AGENTS.md安全与验证AGENTS.md 是每一轮运行的常驻上下文Loop Mode前 1–2 周保持 L1报告 草稿每次运行前必须读状态文件每份草稿都需人工批准后才能发布或开 PR。Safety未经人工明确批准绝不创建 tag、绝不发 GitHub Release、绝不更新 CHANGELOG.mdBreaking changes 与安全项必须显式呈现仅在 L2 启用后才允许 draft PR且绝不自动 merge。Verification校验者检查草稿的完整性分类、日期范围、链接草稿状态与人工反馈要写回状态文件。8.2 LOOP.md节奏、门禁与预算LOOP.md 定义了循环的运行参数Active LoopsPatternCadenceStatusCommandChangelog Drafter1d 或 release 准备期L1 仅草稿opencode run Run changelog-scan经 cron合并稳定后Human Gates人工门禁Breaking changes 永远由人工审查安全说明 / CVE 的措辞必须人工批准未经明确批准不打 tag、不开 PR、不发布前 3 次发布人工批准完整草稿。Budget预算单轮最多 2 个子 Agent 派生scanner drafter优先在合并稳定后晚间运行。Output Convention产物约定草稿 → 仓库根目录RELEASE_NOTES_DRAFT.md状态 →changelog-drafter-state.md。9. 从 L1 到 L2提交草稿 PR第一周保持纯草稿模式L1当草稿质量稳定后模式文档建议第 3 周起可升级到 L2——把批准的草稿以 draft PR 形式提交opencode run \ Run changelog-scan and draft-release-notes. If the draft looks good, create a new branch and commit RELEASE_NOTES_DRAFT.md. Open a draft PR titled chore: release notes draft. Flag breaking changes and security items explicitly in the PR body. Do not merge. \ --agent implementer该命令以--agent implementer指定上文第 6.2 节的实现者子 Agent 执行先过loop-gate check --action commit门禁再提交草稿、开 draft PR并在 PR 正文显式标注破坏性变更与安全项。完整的 L1/L2 演进示例见 examples/opencode/changelog-drafter.md其中 L2 阶段所需的draft-release-notes技能可从 templates/SKILL.md.loop-triage 复制适配Agent 基础配置可参考 starters/minimal-loop-opencode/opencode.json.example。10. 循环如何运转典型一轮结合 patterns/changelog-drafter.md 的完整定义一轮典型循环为确定窗口上次 tag、状态文件中的上次运行日期或最近 N 天changelog-scan列出合入 main 的 PR 与值得注意的直接提交抽取 conventional commit 类型、label如breaking、security、关联 issue归入标准分组Features、Bug Fixes、Performance、Breaking Changes、Security、Documentation、Internal/Chores撰写带链接、致谢、升级提示的精修 Markdown 草稿校验者或人工核对准确性不虚构功能、完整性不漏高影响项、语气与项目口吻批准后循环可打开更新CHANGELOG.md的 PR或仅把草稿留在文件里供维护者复制在状态文件记录本次运行并把已发布项标记为 published修剪旧条目记录 Post-Run Critique遗漏项、误报、分组问题、重试与下一轮提示词调整。11. 失败模式与缓解失败模式缓解措施幻觉功能或归属错误校验者对每一条核对真实 PR 标题与提交信息状态文件追踪来源 PR漏掉重要变更同时扫描 PR和main 上的直接提交使用 label 与 conventional commits草稿过长 / 噪音多严格分类 技能中的仅用户可见项规则人工可裁剪语气与项目不符在 AGENTS.md 或项目技能中提供简短的Release voice章节供草稿者阅读意外发布不给循环标签或线上 CHANGELOG 的写权限除非有显式人工门禁 PR批评记录长期无人处理批评条目跨阈值如 3 轮未解决时触发人工交接完整的循环设计自检清单可参考 docs/loop-design-checklist.md。12. 成本画像场景消耗token/轮说明空转无新合并~5k自上次 tag 无内容时直接退出扫描 分类~35kPR/提交扫描草稿 校验~80k分类发布说明草稿建议节奏为每日一次、Tier 为 low、每日预算上限 100k token。运行前可用成本估算工具验证npx cobusgreyling/loop-cost --pattern changelog-drafter --level L1该命令由 tools/loop-cost/ 提供基于内置注册表 tools/loop-cost/registry.json 估算单轮 token 消耗。总体而言这是性价比最高的低风险循环之一适合作为第二或第三个引入的循环且可安全地与 Post-Merge Cleanup 并行运行——两者搭配的引入时机可参考 docs/pattern-picker.md。13. 成功指标与安全总纲可用以下指标衡量循环效果从最后一次合并到发布说明上线的耗时patch 版目标 1 天首次发布即带说明的比例每轮人工审稿时间应随循环学习项目口吻而下降用户发现但说明中缺失的意外项数量目标趋近于零。安全总纲贯穿整个 starter草稿者只提案、绝不发布校验者只验收、绝不改稿发布动作永远留在人工门禁之后。通用安全细则见 docs/safety.md第一周的实际运行记录与踩坑复盘见 stories/changelog-drafter-week-one.md。赞分享人工智能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 实战用 Opencode 搭建 Changelog Drafter 发布说明生成循环Loop Engineering 实战用 Opencode 搭建 Changelog Drafter 发布说明生成循环 在 loop engineering人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务loop-engineering Changelog Drafter Starter 实战指南从 L1 草稿到 L2 发布准备的 AI 循环搭建loop engineering Changelog Drafter Starter 实战指南从 L1 草稿到 L2 发布准备的 AI 循环搭建 本指南以 l人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务Cursor Changelog Drafter 实战用 Cursor Automations 与 Skill 构建 L1 发布说明草稿循环loop-engineeringCursor Changelog Drafter 实战用 Cursor Automations 与 Skill 构建 L1 发布说明草稿循环loop eng人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务上一篇在Apple Silicon Mac上运行Windows应用Whisky终极指南下一篇5分钟快速上手Wand-Enhancer免费解锁WeMod专业版完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考