Suggestion Triage · 建议分类台
Overview
将 AI 返回的几十条建议转化为一个可纯鼠标点选的决策清单：用户无需大量打字，逐条点选「✅ 要做 / ✏️ 调整 / ❌ 不做」即可完成分类，并支持批量标记、优先级标注、备注、筛选统计与结果导出。工具本体是单文件 HTML（assets/suggestion-triage.html），零依赖、零配置、离线可用，任何设备（Windows / macOS / Linux / 手机）的浏览器双击即开。本 Skill 为通用 Skill，首批支持在 codex、workbuddy 等 agent 软件中使用（打开方式见「触发收尾动作」协议）。其他环境同样可用：工具是独立单文件、无需 agent——手动复制建议文本、双击打开 HTML 粘贴进「导入」框即可标记分类。
最高原则（全局强制约束，任何情况下不可违反）
无论遇到什么情况，都不得使用超出本 Skill 约定范围的方式去达成 Skill 想要达到的目的。
- 本 Skill 中明确约定或禁止的规则（如：不用本机代理 URL 打开文件、只用内置文件浏览器打开、不自动写入系统剪贴板等），必须无条件遵守。
- 如果完成某个目的需要打破本 Skill 已写明的规则，那么即使任务因此无法完成，也不得打破规则——应如实告知用户"受规则限制无法完成"，而不是违规变通。
- 规则的优先级高于完成目标的优先级。任何"为了完成任务而变通"的想法都是违规，包括但不限于：换用本机代理 URL、绕过内置文件浏览器、直接写入剪贴板等。
Quick Start
- 定位工具文件：本 Skill 安装目录下的
assets/suggestion-triage.html（与 SKILL.md 同级）。 - 工具文件会在本 Skill 触发时由 Agent 自动打开（见「触发收尾动作」）；若需手动使用，双击本 Skill 安装目录下的
assets/suggestion-triage.html即可，无需安装任何东西。 - 引导用户完成三步流程：复制 → 一键导入 → 点选标记（详见下文「批次化输出协议」与「引导用户」）。
- 若用户把建议文本直接发给本 Agent，按「Agent 辅助」一节协助处理。
批次化输出协议（核心：AI ↔ 工具 的持续会话流）
用户的典型用法是持续多轮：让 AI 提建议 → 用工具标记 → 再让 AI 提新一批。为让每一轮衔接顺畅，遵守以下规则：
- 当本次回复输出 ≥5 条编号建议时（任何场景，包括评审、优化、改进、Bug 修复建议等，不限于"建议清单"请求），必须在回复末尾用代码块输出完整建议清单，每行一条，格式统一为
[优先级] 序号. 建议标题：建议内容。优先级放在行首，用[高]/[中]/[低]，绝不用 P0/P1/P2 或数字等级；无优先级可省略前缀。例如：
[高] 1. 优化首页加载速度：首屏白屏时间超过 3 秒，需做资源懒加载 [中] 2. 补充用户协议隐私条款：明确数据采集用途与保存期限 [低] 3. 增加客服入口：减少流失
这是强制动作，不可省略——用户会把这些建议复制进「建议分类台」逐条决策，工具会自动识别[高]/[中]/[低]前缀并设置为对应优先级。 - 不要自动写入系统剪贴板（用户明确偏好：不想要 AI 动剪贴板）。提示用户用代码块的复制按钮复制；若当前环境代码块没有复制按钮，则提示「选中代码块内容复制」（或长按选择复制）；用户也可直接从上到下选中正文中的建议文本复制，效果相同。
- 提示用户下一步：打开「建议分类台」→ 点「📥 导入」→ 点「📋 从剪贴板读取」（或 Ctrl+V）→ 确认替换 → 开始标记。
- 工具侧行为（用户无需关心，Agent 需知晓以正确引导）：
- 导入默认替换旧批次（导入前会弹确认）；勾选「追加到现有列表」才追加。
- 页头进度条右侧显示「更新自 HH:MM · N 条」蓝色徽章，即最新一批建议的导入时间与条数，便于确认当前数据。
- 每批新建议导入后，上一批的标记结果即被替换（如需保留请先导出）。
引导用户（三步流程）
第一步 · 复制：告诉用户点代码块右上角的复制按钮；若环境无此按钮，手动选中复制（或长按选择复制）均可。
第二步 · 一键导入：打开工具 → 点「📥 导入」→ 点「📋 从剪贴板读取」或 Ctrl+V → 确认替换 → 建议自动解析为独立条目（优先级前缀自动识别）。
- 需要保留已有数据时勾选「追加到现有列表」；想先体验可点「✨ 示例」载入演示数据。
第三步 · 点选标记：逐条点击右侧按钮，几十条通常 1-2 分钟可完成。可利用筛选标签先处理「未标记」的剩余条目。全部标记完才能导出（未选完会提示剩余条数），点底部「📋 复制结果」发回给 AI。
> 环境提示：若用户在嵌入的预览面板中操作、点「确认/删除」没反应，请提醒其改用系统浏览器双击打开文件（面板展示的是文件副本，双击打开最稳）。
首次使用教程（第 1 次引导用户时）
- 让用户点页头「✨ 示例」载入 7 条演示数据，认识界面：编号徽章、名称/内容、优先级、右侧按钮、左侧色条。
- 点「✅ 要做」观察卡片绿边、按钮变绿；点「✏️ 调整」观察展开备注框并填一句；点「❌ 不做」观察整卡变灰（红边框+红竖线）。三种状态直接切换。
- 全部标完 → 底部「📋 复制结果」→ 把结果发回给 AI。
30 秒完整示例（向用户演示"走一遍是什么样"）：
> AI 给出：[高] 1. 优化首页加载速度：首屏白屏超 3 秒、[中] 2. 补充隐私条款：明确数据用途、[低] 3. 增加客服入口：减少流失
> ① 复制 → 点「📥 导入」粘贴 → 识别出 3 条，[高]/[中]/[低] 自动变成红/橙/灰优先级标签；
> ② 第 1 条点「✅ 要做」（绿边）、第 2 条点「✏️ 调整」填备注「下季度再上」、第 3 条点「❌ 不做」（整卡变灰）；
> ③ 点「📋 复制结果」，得到 【要做】1. 优化首页加载速度、【调整】2. 补充隐私条款 ｜ 备注：下季度再上、【不做】3. 增加客服入口，回贴给 AI 即完成决策。
工具能力（assets/suggestion-triage.html）
核心功能（首次使用先看这几条）：
- 导入：粘贴 AI 建议文本，自动解析为条目。支持编号格式（
1.、1、、①、F1、-等）按编号块合并解析；无编号时按行解析；行首[高]/[中]/[低]优先级前缀自动识别并设置为对应优先级；也支持粘贴 JSON 数组或{items:[...]}。弹窗内「📋 从剪贴板读取」一键读取剪贴板填入。导入默认替换旧批次（弹确认），可勾选追加；默认自动去重（按原文编号或名称，重复条目跳过并在确认提示中告知数量，可勾选「保留重复」关闭）；确认弹窗会先显示「解析出 N 条建议」供核对。 - 条目结构（清单卡片风格）：编号徽章 + 优先级徽章（无则「无优先级」）+ 建议名称（加粗）+ 建议内容（灰色）+ 右侧按钮
✅ 要做 / ✏️ 调整 / ❌ 不做 / 🗑 删除；左侧色条标识状态。 - 标记机制：点击按钮标记，三种状态直接切换、不再取消。「调整」状态必有备注——点「调整」展开行内输入框补充备注，自动保存。三种状态视觉效果对照：
| 状态 | 卡片 | 左侧色条 | 按钮 |
|---|---|---|---|
| 要做 | 绿边框 | 绿 | 绿（高亮加粗） |
| 调整 | 橙边框 | 橙 | 橙（高亮加粗） |
| 不做 | 整卡变灰（半透明）+ 红边框 | 红 | 红（高亮加粗） |
| 未标记 | 默认白底灰边 | 灰 | 默认 |
- 备注语义：备注/调整说明是「调整」状态专属——选「要做/不做」时不显示备注内容；导出（文本/JSON）仅调整条目携带「｜ 备注：…」。
- 导出：文本格式（
【要做】1. 名称 ｜ 备注：...，直接从【要做】开始、无标题头、只含序号+标题、备注仅调整条目）或 JSON 格式，可复制到剪贴板、下载.txt/.json（文件名带日期时间戳防覆盖）。底部「📋 复制结果 / ⬇ 下载结果文件」要求全部选完才允许（未选完 toast 提示剩余条数）。 - 筛选与统计：筛选标签（全部/未标记/要做/调整/不做）实时显示各分类条数，刷新后保留；顶栏搜索框按关键词过滤名称/内容（
/快捷键聚焦、Esc 清空）；进度条按完成度变色（蓝→橙→绿，100% 显示「已完成 ✅」）及「更新自 HH:MM · N 条」批次徽章（hover 显示完整时间）；全部标记完时 toast 提示并让「复制结果」按钮脉冲高亮。
进阶功能（可跳读，需要时再看）：
- 优先级：每条可点选优先级徽章循环切换：无 → 高 → 中 → 低（高=红、中=琥珀、低=灰，标签显示「高/中/低」不带 P 前缀）。优先级怎么选：高=不解决会阻塞或影响大（如 Bug、合规问题）；中=有价值但可延后（如体验优化、下个迭代）；低=锦上添花、可做可不做；不确定可保持「未设优先级」或选「中」。
- 排序与分组：工具栏「⇅ 优先级」按 高→中→低 排序列表；「⊞ 分组」按编号前缀（F/T/U…）分组展示（组标题带条数），无编号归入「数字/其他」。
- 误删恢复：删除的条目进入「♻ 最近删除」（最多 20 条，持久化），可逐条恢复（toast 显示恢复的条目名）或清空记录。
- 编辑：点「名称」或「内容」行内编辑（触屏设备需双击，防误触）；「调整」状态必有备注——标记为「调整」且备注为空时自动打开备注框（备注已有内容则不自动弹，按
Enter打开）。备注框内：有内容时Enter保存、Esc弹「是否退出」确认；无内容时Enter弹「请输入文本」、Esc直接取消「调整」标记。 - 持久化：自动保存到浏览器 localStorage（含条目、批次时间、最近删除、筛选/排序/分组等界面状态）；不支持时自动降级并提示及时导出。
- 快捷键（鼠标为主，键盘加速）：
↑/↓选行、Z要做、X调整（备注空则自动打开备注）、C不做、Enter打开备注、P优先级、Del删除当前行、/聚焦搜索；窄屏底部「?」按钮弹出快捷键帮助。 - 其他：深色/浅色主题切换、阅读字号 A−/A+、打印样式、
prefers-reduced-motion适配、🩺 环境自检（含隐私声明）、移动端响应式（窄屏按钮换行至内容下方）、示例数据一键载入、条目 hover 上浮与按钮点击反馈、页脚版本号可点查看更新记录。
触发收尾动作（通用 Skill 协议，每次触发必做）
本 Skill 是通用 Skill，首批支持 codex 与 workbuddy 两个 agent 软件。无论运行在哪个软件中，触发本 Skill 后必须在回复结束前，用该软件的内置文件浏览器打开工具 HTML 文件本身。这是强制动作，不可省略。
- 时机：完成本轮的辅助/引导/导出汇总之后、回复结束之前（即最后一步）。
执行步骤（严格按序）
- 检测运行环境：识别当前对话运行在哪个厂商的 agent 软件中（codex / workbuddy / 其他）。判断依据：当前可用的工具集、内置文件浏览器/预览能力等。
- 定位工具文件绝对路径：查找本 Skill 安装目录下
assets/suggestion-triage.html（即与当前正在阅读的 SKILL.md 同级目录下的assets/suggestion-triage.html），获取其绝对路径；首次安装本 Skill 后应执行一次此定位（可在首次触发时记录该路径备用）。禁止使用相对路径——相对路径会被解析到当前项目目录导致找不到文件。 - 复制到当前项目根目录：将第 2 步定位到的 HTML 文件复制一份到当前项目根目录（即本次调用本 Skill 的对话所在项目），命名为
suggestion-triage.html；若项目根目录已存在同名文件，则跳过复制；若内容与本 Skill 内文件不一致，则同步更新。 - 以内置文件浏览器打开文件本身：调用当前软件的内置文件浏览器/文件查看能力，打开第 3 步项目根目录中的
suggestion-triage.html。必须打开文件本体，不得以127.0.0.1/localhost/http://…等本机代理 URL 形式打开。若因权限等原因无法打开，向用户请求授权（说明需要打开该文件，请用户允许访问）。 - 务必打开成功：必须确保内置文件浏览器成功打开该文件——这是降低用户操作成本、提高效率的关键，而不是让用户手动去目录里找文件双击。若第 4 步因权限被拒或打开失败，应重新尝试（再次请求授权、换用当前软件的其他内置打开能力等），直至打开成功。
- 注意：部分环境的展示面板呈现的是文件副本，若 HTML 文件在对话过程中被修改，需重新展示才会加载最新版；涉及修改 HTML 的会话，应在修改完成后再执行打开。
Agent 辅助
- 用户把建议文本发给本 Agent 时：不要替用户完成全部标记（分类是用户的主观决策），但可以主动帮用户把文本整理成规整的格式（
[高] 1. 名称：内容每行一条，优先级用 高/中/低）并用代码块输出，提示其复制后粘贴进工具的「导入」框。 - 用户询问某条建议「是否该做」时，给出客观分析（成本/收益/风险）供其决策，不代替点选。
- 用户已完成分类并粘贴导出结果时，按分类汇总：列出「要做」清单并给出执行顺序建议、「调整」逐条给出具体修改点、「不做」简述放弃原因是否合理。
- 多轮会话：当用户基于上一批建议的结果继续提问（如「再来一批」），按「批次化输出协议」输出新代码块，并提示旧批次将被工具自动替换。
常见问题（FAQ）
用户报告工具异常时，按以下常见问题快速定位（均已在工具内处理或可降级）：
Q：点「确认 / 删除 / 清空」按钮没反应？
A：部分嵌入的预览窗口会拦掉弹窗。工具已改用自定义弹窗；若仍无反应，用系统浏览器双击打开文件即可。
Q：「从剪贴板读取」提示读不到？
A：浏览器需要你手动点一下并授权，某些环境会拒绝。直接 Ctrl+V 粘贴到导入框即可。
Q：提示「不支持自动保存」？
A：当前浏览器的本地存储被关了（比如隐私模式）。功能还能用，但刷新会丢数据，处理完请立即导出。
Q：预览面板和文件内容不一致 / 改了没生效？
A：面板显示的是文件副本。改完 HTML 后重新打开才会加载最新版。
Q：代码块没有复制按钮？
A：部分环境的代码块不提供复制按钮，属正常现象，手动选中复制即可。
Q：该选哪个优先级？
A：高=必须做/影响大（如 Bug、合规问题）；中=有价值可延后；低=可做可不做。不确定可先选「中」或保持未设优先级。
Q：在老旧浏览器里能用吗？
A：建议用近两年的 Chrome / Edge / Firefox / Safari。老旧浏览器（如 IE、极老版本）可能不支持本地存储、颜色混合等功能，会自动降级或样式异常，建议升级浏览器。
Resources
assets/suggestion-triage.html—— 唯一的核心交付物：单文件 HTML 应用（HTML+CSS+JS 全部内嵌，无任何外部依赖，可离线使用）。复制到任何设备直接双击打开即可独立运行，不依赖本 Skill 环境。
