triage-reflections 是一个用于 Claude Code 的技能,作用是把 reflect 账本中带有 REFLECT 标记、尚未处理的学习项(pending learnings)分流并提交为 GitHub issue。它明确定位为仅负责归档 issue,不编辑任何技能;技能的修改由 skill-updater、/implement 和 /fleet 等承担。相关引用包括:reflect 命令位于 ~/.claude/bin/reflect;路由规则见 skills/meta/reflect/references/routing.md;issue 正文、标签、去重和 -R 仓库参数见 skills/meta/reflect/references/issue-format.md。
使用方式与流程:
- 加载:运行 reflect marker ls --json --status pending,若为空则说明并停止。
- 推断:对没有 skill 或 scope 的学习项,读取其 text、before、after 和 file,匹配到仓库技能(<repo>/.claude/skills/)或库技能(由 reflect status 给出库路径),并按 routing.md 把已安装副本解析到库源。
- 合并与丢弃:将同一技能、同一 scope 且表达相同内容的学习项合并为一条,保留全部示例(file、line、before/after)和类似“seen in 4 places”的计数;重复即为证据,合并后的学习项仍计入提案所需的 3+。仅当现有技能、AGENTS.md、规则或 lint 配置已陈述该内容时,才标记为 rejected,且需实际阅读目标确认,不得假设。
- 提案:展示表格,每项一行,包含 ids、text、count、route、reason,等待用户逐行接受、修改或拒绝;在此之前绝不提交 issue。
- 提交已接受的行并逐项标记。
- 对 deferred 和 promoted 的学习项提出向上提案。
- 报告 issue URL、提案以及 promoted、deferred、rejected 的数量。
路由规则:scope 为 global 且指明库技能的学习项,在技能源仓库提交一个 issue 并标记 promoted;scope 为 repo 且指明仓库技能的学习项,在学习项的 repo 字段对应仓库提交 issue(从其 origin 传 -R <owner>/<repo>)以修订该技能并标记 promoted;kind 为 later、scope 为 repo 的学习项,通过 file-issue 的 inbox 模式在该仓库提交 inbox issue 并标记 promoted;scope 为 repo 但没有技能(REFLECT(repo)),或没有 owner 且没有其他学习项共享主题的,不提交,标记 deferred;用户拒绝或第 3 步被丢弃的,不提交,标记 rejected。合并项只走一条路由,其中每个学习项都获得该项的标记和 --issue URL。
按技能分组:每次运行每个技能一个 issue,列出该技能的全部条目;使用 reflect issue 格式,标签为 reflect 和 status:ready,库 issue 另加 from: 行;在 Evidence 下放入每个条目的计数和每个示例的 before/after。机械性经验(脚本或 linter 可捕获的)还需在技能的 lint/ 目录按既有形式(如 Go 的 forbidigo、errorlint)请求代码片段。全局 issue 始终使用通用示例:重写每个 before/after,并去掉仓库名、路径和私有标识,无论库仓库是否公开;公开仓库上的 repo issue 同样做通用化处理;来自私有仓库的 issue 保留代码原样。
提案:标记完成后运行 reflect marker ls --json,考虑所有 status 为 deferred 或 promoted 且 proposal 字段为空的学习项;已带 proposal URL 的属于已提交分组,应跳过,避免重复提案。分组规则:同一仓库同一主题下 3+ 个学习项,且 skill 字段为空、<repo>/.claude/skills/ 中没有仓库技能覆盖该主题,则在该仓库提交一个 issue,建议添加仓库技能、AGENTS.md 条目或 ADR;同一经验出现在 2+ 个仓库,则在最可能的库技能源仓库提交一个 issue 并带 from: 行。判断“同一主题”和“同一经验”需阅读 text、before 与 after,不确定时排除该学习项。提案需先展示给用户并等待接受后再提交,规则同第 4 步。提案列出每个学习项(id、text、repo、before/after)作为证据,到此为止,不包含技能草稿、建议措辞或补丁。使用 reflect issue 格式,标签为 reflect,全局和公开仓库 issue 遵循上述通用化规则。提案创建后,对其中的每个学习项保持原状态并记录 URL:reflect marker mark <id> <current-status> --proposal <proposal-url>。--proposal 与 --issue 分开,因此 promoted 的学习项保留自己的 issue 链接。
标记:每个 issue 提交后,对其中的每个学习项执行 reflect marker mark <id> promoted --issue <issue-url> [--scope global|repo] [--skill name]、reflect marker mark <id> deferred 或 reflect marker mark <id> rejected。必须在 issue 存在后才标记,以便提交失败时学习项保持 pending 供下次运行处理。若第 2 步推断了 scope 和 skill,则在标记时传入 --scope 和 --skill。再次运行 ls --status pending 时,不应显示任何已处理项。
适用场景:定期整理反思记录、将重复出现的经验转化为可跟踪的 GitHub issue、区分需升级到库技能的通用经验与仅限单仓库的经验。限制:仅归档 issue,不修改技能;不生成技能草稿、措辞或补丁;判断主题与相同性依赖阅读而非自动假定。收费、价格、平台支持等信息暂未提供。