)
人工智能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/issue-triage/.claude/skills/issue-triage/SKILL.md为骨架完整讲解 Issue TriageIssue 队列健康技能的设计与落地它如何扫描 open issues 与 discussions、去重、打分P0–P3、提出建议标签并持续维护issue-triage-state.md滚动状态文件。读完本文你将掌握该技能的输入信号、评分规则、L1 只提不改的安全边界、L2 白名单标签机制以及它与 Daily Triage 的配对协作方式并能在自己的仓库中直接部署运行。技能定位Issue 队列健康 Agent该技能在仓库中同时存在两份等价文件Claude Code 专用版 SKILL.md 与可复用模板 templates/SKILL.md.issue-triage两者的 frontmatter 与正文完全一致。其核心定义是You are an issue queue health agent. Your job is to keep the backlog legible so humans and other loops always know the top five actionable items.技能的前置元数据frontmatter给出三条关键约束字段值含义nameissue-triage技能标识供/loop命令与循环注册表引用description扫描 open issues 与 discussions去重、排优先级、建议标签更新issue-triage-state.mdL1 只提不改绝不自动打标签或关闭决定该技能是否/何时被调度器选中user_invocabletrue用户可主动显式调用在 patterns/registry.yaml 的模式注册表中该技能被登记为issue-triage模式的一部分cadence: 2h-1d、risk: low、skills: [issue-triage, loop-verifier]、state: issue-triage-state.md、phases: [discover, dedupe, score, propose-labels, human-review]。这直接印证了技能设计文档中低风险、高杠杆的定位——它是一个非常适合常驻运行的伴生循环。输入信号技能读取什么技能文档明确列出三类输入开放的问题与讨论GitHub issues 和 discussions若配置了 MCP也可通过 Linear / Jira 接入examples/grok/issue-triage.md 提到可用 GitHub MCP 只读模式发现 issue 与关联 PR 信号上一次运行的issue-triage-state.md作为循环记忆实现增量扫描而不是每次全量重扫信号集age存活时长、author作者、labels已有标签、comments评论、reactions表情反应、linked PRs关联 PR、milestone里程碑。这些信号是后续打分与去重的原始依据。例如 patterns/issue-triage.md 中的循环流程第一步就是发现自上次运行以来新增/更新的 issues 与 discussions首次运行则扫描全部 open 项随后逐条提炼意图、检测重复、拉取信号。输出契约issue-triage-state.md的固定结构技能每次运行的核心产出是更新issue-triage-state.md其模板结构必须严格遵循# Issue Triage State Last run: ISO timestamp Open actionable: N (was M) New since last run: K Needs human: H ## Top 5 (by loop score) - #NNN (p1, 2d old) — one-line summary — suggested: label1, label2 ## Proposed Labels (not applied in L1) - #NNN: label-a, label-b ## Possible Duplicates (human confirm) - #NNN — possible duplicate of #MMM ## Noise / Ignored - brief list头部四个计数器Last run、Open actionable、New since last run、Needs human构成一次运行的健康快照主体四个分区分别承载优先级队列、建议标签、待人工确认的重复项与被忽略的噪声。仓库提供了可直接套用的脚手架文件 starters/issue-triage/issue-triage-state.md.example首次运行前将其复制为issue-triage-state.md即可。它额外补充了技能正文中未展开的两个清单值得原样保留Allowlisted labels (L2 only)area:*、needs-repro、needs-infoDenylist (always human)auth、payments、security、public-api、breaking-change。patterns/issue-triage.md 给出了一个真实形态的运行示例展示状态文件如何记录Open actionable: 14 (was 17)这类环比变化以及 Top 5 条目中#487 (bug, p1, 2d old) — Crash on export with large files — suggested: bug needs-repro area:export的完整写法。注意 Top 5 条目内嵌了四项压缩信息issue 编号、优先级与标签、存活时长、一句话摘要、建议标签集——这正是让人类和循环一眼看清队列的设计目标。评分规则P0–P3 四级优先级 两个特殊桶技能核心的决策模型是打分分桶表部署时必须原样落地优先级触发信号P0安全Security、生产故障prod breakage、数据丢失data lossP1高影响 清晰的复现路径或明确的客户痛点P2有效的功能/缺陷但不紧急P3锦上添花、文档类、打磨类needs-info规格不清、缺少复现步骤duplicate?标题/正文与既有 issue 高度重叠这套打分与 patterns/issue-triage.md 中典型循环周期的第 3 步完全对应先打分分桶再写回状态文件。同时注册表phases: [discover, dedupe, score, propose-labels, human-review]也印证了打分之后必须跟人工复核的阶段顺序。规则与安全边界L1 只提不改技能正文用 Rules 小节约束了行为的硬性边界这是整个设计中最关键的部分L1第一周只提不改只建议标签和优先级绝不实际应用标签、发表评论或关闭 issue自动升级needs human凡涉及auth认证、payments支付、security安全、public API、billing计费、infra基础设施的 issue一律移交人工保守去重重复检测只输出 possible duplicate of #NNN 这样的可能性表述绝不自动关闭每次运行剪除已关闭 issue保持状态文件只保留需要关注的项目保持简洁——该循环在繁忙仓库可能每 2 小时运行一次输出必须克制。starters/issue-triage/README.md 的 Safety 一节再次强调No auto-label or close in L1并将 denylist 指向 docs/safety.md。starters/issue-triage/LOOP.md 的 Human Gates 表则从循环配置视角复述了同一组人工闸门P0/P1 归属判定前几周仅限人工、认证/支付/安全/公共 API 永远升级、重复项关闭与过期项关闭均需人工确认。L2 白名单标签机制只有验证器通过后才能自动应用技能为后续演进预留了 L2 阶段——在 verifier 通过后可以自动应用白名单标签area:*、needs-repro、needs-info—— 但绝不自动应用P0、P1、breaking-change或security。这背后的 maker/checker 分离由 skills/loop-verifier/SKILL.md 提供loop-verifier 作为独立的检查者角色默认立场是REJECT until proven otherwise对实施者提交的变更执行五项检查变更范围、意图匹配、亲自运行测试、无作弊断言、中高风险建议人工复核输出APPROVE | REJECT | ESCALATE_HUMAN裁决。Issue Triage 从 L1 升到 L2 的门槛就是由 verifier 对建议标签变更做 sanity check通过后才允许在area:*等低风险标签上自动应用。starters/issue-triage/LOOP.md 的 Budget 一节也明确了对应预算约束Max sub-agent spawns per run: 1 (L2 label apply with verifier)——即每次运行最多只允许生成一个 L2 子 Agent 用于带验证器的标签应用。examples/grok/issue-triage.md 给出的演进路径清晰地总结了三个阶段L1第 1–2 周只建议标签与优先级人工手动应用L2第 3 周起verifier 通过后自动应用白名单标签area:*、needs-repro永不可无人值守P0/P1 及认证、支付、安全、公共 API 相关事项仅限人工处理。与 Daily Triage 的配对协作技能正文末尾专门强调与 Daily Triage 的配对关系Daily Triage 读取issue-triage-state.md将 Top 5 合并进STATE.md的 High Priority 区。不要在 STATE.md 中重复完整 issue 正文只引用 issue 编号。这是一种典型的高频喂料 低频汇总架构Issue Triage 以 2h–1d 的高频运行持续产出干净的优先级队列patterns/daily-triage.md 定义的 Daily Triage 以 1d 为节奏在晨间读取该状态文件并把 Top 5 合并进STATE.md的 High Priority 列表。starters/issue-triage/LOOP.md 的 Pairing 一节用一句话概括Issue Triage 作为 Daily Triage 的feeder运行。而引用编号而非复制正文的约定是为了防止STATE.md无限膨胀、保持人类和其他循环都清楚知道 top 5这一核心目标。部署与运行从零启动 Issue Triage 循环步骤一用 loop-init 脚手架生成starters/issue-triage/README.md 提供了一键生成命令按所用工具选择其一# Grok npx cobusgreyling/loop-init . --pattern issue-triage --tool grok # Claude Code npx cobusgreyling/loop-init . --pattern issue-triage --tool claude # Codex npx cobusgreyling/loop-init . --pattern issue-triage --tool codex也可先加--dry-run预览将要生成的文件见 examples/grok/issue-triage.md。生成后项目将包含四个核心文件文件用途issue-triage-state.md.example滚动积压健康快照复制为issue-triage-state.md.grok/skills/issue-triage/或对应工具目录Issue 扫描 排优先级技能本体.claude/agents/loop-verifier.md或等价物L2 标签应用检查器LOOP.md节奏与人工闸门配置步骤二首次启动命令以 Grok 第一周运行为例examples/grok/issue-triage.md/loop 2h Run the issue-triage skill. Read issue-triage-state.md first. Scan open issues and discussions since last run. Update issue-triage-state.md with: - Top 5 prioritized items (P0–P3) with one-sentence summaries - Suggested labels (proposed only — do not apply) - needs human bucket for ambiguous or security-sensitive items Do not auto-label, close, or comment on issues. Escalate duplicates as possible duplicate of #NNN for human confirmation.繁忙仓库可改用更快的节奏/loop 1d Run issue-triage at start and end of day. Report mode only.Claude Code 的等价命令patterns/issue-triage.md/loop 2h $issue-triage — update issue-triage-state.md. Propose labels only on allowlisted areas. Human review for P0/P1.步骤三调度方式patterns/issue-triage.md 推荐三种调度来源可组合使用TUI 侧/loop 2h或/loop 1d繁忙仓库晨间 日末各跑一次GitHub Actions监听issues/discussion事件外加定时兜底可参考仓库中 examples/github-actions 目录下的 starter workflowCodex每 2 小时或在issues事件上自动化触发纯报告模式。失败模式与缓解预先设计好的防御patterns/issue-triage.md 专门列出三种典型失败模式及缓解方案可直接复用到你自己的部署中失败模式缓解方案过度优先吵闹的报障者按团队真正关心的信号加权reactions、关联 PR、内部 1人工覆盖记录在状态文件中重复检测误报保守匹配L1 阶段一律以 possible duplicate of #NNN 形式交给人工确认每个新 issue 都触发告警疲劳只对 needs human 切片通知人类其余内容留在状态文件供 Daily Triage 或工程师读取成功度量如何验证这个循环是否有效同文档给出四类可量化指标用于判断循环质量issue 从打开到获得第一个有意义的标签或 needs info 评论的时间缩短幅度24 小时内具备明确优先级的 issue 占比工程师对 我始终知道 top 5 是什么 的主观评分来自状态文件评审在两个人开始处理同一件事之前就捕获到的重复 issue 数量。总结Issue Triage 技能是 loop-engineering 中低风险、高杠杆循环的典型样本它以固定结构的issue-triage-state.md为记忆与输出契约用 P0–P3 打分表统一优先级语言用 L1 只提不改 denylist 升级 保守去重三道防线守住安全边界用白名单标签与 loop-verifier 铺平向 L2 演进的路径并通过与 Daily Triage 的喂料配对把高频队列转化为晨间可执行清单。核心文档为 starters/issue-triage/.claude/skills/issue-triage/SKILL.md 及其等价模板 templates/SKILL.md.issue-triage进一步延伸可阅读 patterns/issue-triage.md完整循环定义、starters/issue-triage/README.md部署步骤与 examples/grok/issue-triage.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 实战用 issue-triage Skill 搭建只读的 Issue 队列健康巡检循环loop engineering 实战用 issue triage Skill 搭建只读的 Issue 队列健康巡检循环 导读 本文围绕 loop engin人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务loop-engineering 的 issue-triage 技能用 AI Agent 保持 Issue 队列永远可读、可行动loop engineering 的 issue triage 技能用 AI Agent 保持 Issue 队列永远可读、可行动 导读 issue triag人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务Loop Engineering 的 Issue Triage 模式用 loop-init 搭建只读提议式 Issue 队列治理循环Loop Engineering 的 Issue Triage 模式用 loop init 搭建只读提议式 Issue 队列治理循环 本文介绍 loop en人工智能AI AgentAgent 工作流CLI研发协作AI 技能MCP 服务上一篇终极网页剪辑指南如何使用 MaoXian Web Clipper 实现本地化信息管理下一篇Mars3D三维地球开发平台完整使用指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考