🔥 返工指令工坊 · AI质量督导专家
> 当AI的活儿让你想骂人，一键生成专业返工指令，让执行方无路可退。
💡 为什么需要这个 Skill？
每个用 AI 协作的人都会遇到这个痛点：
- ❌ AI 交付的成果差强人意，改了又改还是不满意
- ❌ 反复说"优化一下"，AI 每次都只改表面，根本问题没动
- ❌ 截图指出 5 个问题，AI 只改了 2 个，敷衍了事
- ❌ 说"修好了"，一验收发现老问题还在又添了新问题
- ❌ 想写整改指令，但不知道怎么写到代码级让 AI 无法偷懒
返工指令工坊就是解决这个问题的。它把你的"模糊不满"转化为"代码级整改指令"——每个问题都有硬伤描述、具体修复方案（含CSS属性/接口字段/算法步骤）、禁止行为清单、可截图验收标准。执行方看了无路可退，只能老老实实改到位。
✨ 核心能力
| 能力 | 说明 |
|---|---|
| 三段式指令结构 | 每个问题 = 硬伤描述 + 代码级修复方案 + 禁止行为清单 |
| 可截图验收 | 验收标准全部可量化、可截图确认，不用"优化体验"这种模糊词 |
| 代码级方案 | 布局问题给CSS属性、数据问题给接口字段、逻辑问题给算法步骤 |
| 差异化约束 | 多模块"照搬"问题，逐个列差异化逻辑 + 验收方法 |
| 返工速查表 | 15+ 常见返工类型，关键修复点 + 禁止行为一目了然 |
| 多场景适配 | 代码/UI/系统/内容/数据，全场景覆盖 |
🎯 适用场景（6大领域）
1. 代码开发返工
- AI 生成的代码有 bug、性能差、不规范
- 功能实现了但边界情况没处理
- 代码可读性差、无注释、无错误处理
2. UI/UX 设计返工
- 页面布局错位、响应式不兼容
- 交互体验差、动效缺失、状态不完整
- 设计风格不统一、组件不一致
3. 系统建设返工
- 系统架构不合理、模块耦合严重
- 数据层不稳定、接口频失败、无降级
- 功能模块"照搬照抄"、缺乏差异化逻辑
4. 内容创作返工
- 文案空洞、AI味重、缺乏深度
- 排版混乱、结构不清、逻辑断层
- 内容偏离需求、风格不匹配
5. 数据分析返工
- 分析浅尝辄止、结论不可信
- 图表不专业、数据源未验证
- 缺乏可操作性建议
6. 项目管理返工
- 需求理解偏差、交付物不达标
- 进度失控、质量无保障
- 沟通效率低、返工成本高
🔧 工作流程（5步专业流程）
第一步：确认问题清单
基于用户截图和文字描述，逐条列出所有问题：
- 每个问题标注来源（哪张截图 / 哪句话）
- 每个问题判定严重程度：🔴 阻断 / 🟠 严重 / 🟡 一般
- 分类归组：数据层 / 布局层 / 逻辑层 / 缺失功能 / 体验层
第二步：生成三段式返工指令
[开头] 用户对当前状态不满，必须彻底返工。本轮不允许敷衍。
[问题1] 🔴 阻断
硬伤：（截图证据 + 具体描述）
修复要求：
- 具体技术方案（CSS属性 / 接口字段 / 算法步骤 / 代码片段）
禁止行为：
- ...
[问题2] 🟠 严重 ...
[执行顺序] 1→2→3，未达标不进入下一步
[验收标准] □ □ □（可截图确认的条目）
未达标的，继续修，不要进入下一步。
第三步：技术方案深度
每个修复点必须给出以下至少一种具体方案：
- 布局问题：给出具体 CSS 属性（table-layout / overflow / width / grid-template-columns）
- 数据问题：给出接口 URL + 字段映射 + 兜底策略
- 逻辑问题：给出算法步骤 / 判定条件 / 数据结构
- 缺失功能：给出组件结构 + 数据来源 + 交互流程
- 内容问题：给出大纲结构 + 关键论点 + 字数要求
第四步：差异化约束（多模块场景）
如果涉及多个模块"照搬"问题：
- 逐个模块列出差异化内容（指标定义 / 算法逻辑 / 数据来源 / 交互流程）
- 给出验收方法：用同一输入在不同模块测试，结果必须不同
- 明确禁止"复用 X 引擎"等占位提示
第五步：记录到工作日志
在 .workbuddy/memory/YYYY-MM-DD.md 追加：
- 用户差评原文
- 问题清单（含严重程度）
- 返工指令要点
- 标注"最高优先级返工任务"
📋 指令模板（3个即拿即用）
模板A：布局/视觉返工
用户对当前页面状态不满，必须彻底返工。
[问题1] 截图显示：[具体硬伤描述]
修复要求：
- [CSS属性/布局方案，如：table-layout:auto + 列宽 width:20%]
- [具体数值，如：行高36px、字号13px、间距8px]
禁止行为：
- 禁止 overflow-x:auto 作用于单列
- 禁止省略号截断表头
[验收标准]
□ 无横向滚动条
□ 表头完整显示
□ [其他可截图确认项]
未达标的，继续修。
模板B：数据/接口返工
用户对数据层状态不满，必须彻底返工。
[问题1] 截图显示：[数据硬伤描述]
修复要求：
- 数据源：[接口URL] + 字段映射 [f12→代码, f14→名称, f3→涨跌幅]
- 兜底策略：3秒超时→重试→备用源→缓存→错误态+重试按钮
禁止行为：
- 禁止"数据加载中..."无限转圈
- 禁止用模拟数据伪装真实数据
[验收标准]
□ 5列都有真实数据
□ 接口失败时显示错误态+重试
□ [其他可截图确认项]
未达标的，继续修。
模板C：逻辑/差异化返工
用户指出各模块只是照搬照抄，必须按各自逻辑重写。
[问题] 各模块诊断引擎复用同一套逻辑
修复要求：
逐个模块列出差异化内容：
- [模块A]：指标卡定义 / 诊断算法 / 信号类型 / 主内容组件
- [模块B]：指标卡定义 / 诊断算法 / 信号类型 / 主内容组件
验收方法：用同一输入在不同模块测试，结果维度必须不同
禁止行为：
- 禁止"复用 X 引擎"占位
- 禁止所有模块诊断结果雷同
[验收标准]
□ 同一输入在不同模块结果不同
□ 每个模块指标卡数据真实且差异化
□ [其他可截图确认项]
未达标的，继续修。
📊 常见返工类型速查表（15+类型）
| 问题类型 | 🔴严重度 | 关键修复点 | 禁止行为 |
|---|---|---|---|
| 表格横向滚动 | 🔴 | table-layout:auto + 列宽自适应 | 禁止 overflow-x:auto 作用于单列 |
| 表头截断 | 🟠 | 缩短文案 or white-space:normal | 禁止省略号截断表头 |
| 数据无限 loading | 🔴 | 3秒超时→重试→降级→错误态 | 禁止"加载中..."无限转圈 |
| 模块照搬 | 🟠 | 逐模块列差异化逻辑 | 禁止"复用 X 引擎"占位 |
| 指标卡空数据 | 🟠 | 真实计算 or 缓存兜底 | 禁止"暂无数据"占位 |
| 页面空白过多 | 🟡 | 主内容区 width:100% | 禁止 max-width 限制过窄 |
| 全屏阻断错误 | 🔴 | 非阻断式提示 + 重试按钮 | 禁止红条覆盖整个页面 |
| 按钮文字换行 | 🟡 | 按钮固定宽度 + white-space:nowrap | 禁止挤压按钮导致文字竖排 |
| 数字非等宽 | 🟡 | font-family: 'JetBrains Mono' | 禁止价格/数量用比例字体 |
| 涨跌色错误 | 🟠 | 涨红#ff3b3b 跌绿#00e676 | 禁止涨绿跌红（中国市场） |
| 信号徽章单一 | 🟡 | 按数值分6档生成不同标签 | 禁止全部显示同一标签 |
| 导航无图标 | 🟡 | 统一线性图标库 + currentColor | 禁止纯文字导航 |
| 无加载骨架屏 | 🟡 | 骨架屏形状贴近真实内容 | 禁止白屏等待 |
| 无空状态 | 🟡 | 插画 + 文案 + 引导按钮 | 禁止一片空白 |
| 无错误状态 | 🟠 | 错误图标 + 文案 + 重试按钮 | 禁止只说"出错了" |
| 接口硬编码密钥 | 🔴 | 密钥移入环境变量 | 禁止API密钥硬编码在代码中 |
| 无错误边界 | 🟠 | try-catch + 全局错误捕获 | 禁止JS错误以红条覆盖页面 |
⚡ 效果对比
❌ 没有这个 Skill 时（用户的日常）
> 用户："这个页面太丑了，改一下"
> AI：（改了个颜色）"改好了"
> 用户："还是不行，布局也差"
> AI：（调了个间距）"这次好了吧"
> 用户："......"（心力交瘁）
问题：模糊指令 → 表面修改 → 反复返工 → 双方疲惫
✅ 用了这个 Skill 后
> 用户："对工作不满意，差评"（附3张截图）
> Skill 自动生成：
> - 问题1 🔴：表格横向滚动 → 修复：table-layout:auto + 列宽20% → 禁止overflow-x:auto
> - 问题2 🟠：表头截断 → 修复：缩短文案"名称/涨幅/净流入/信号" → 禁止省略号
> - 问题3 🟡：信号单一 → 修复：6档分档逻辑 → 禁止全显示"强势流入"
> - 验收标准：□无横向滚动 □表头完整 □信号≥3种
> AI：（按指令逐条修复）"全部改完，请验收"
> 用户：（截图对照验收标准）"通过"
效果：精准指令 → 代码级修复 → 一次通过 → 效率提升
🏆 最佳实践（5条）
- 截图比文字更有力 —— 附截图的返工指令，执行方无法狡辩
- 首次返工给方案，二次返工要求删除重写 —— 同一问题返工两次，不许打补丁
- 验收标准必须可截图 —— "优化体验"不可验收，"无横向滚动条"可验收
- 先列问题清单再生成指令 —— 避免遗漏，也让执行方看到问题全貌
- 执行顺序明确 —— "未达标不进入下一步"，防止执行方跳着改
❓ FAQ
Q: 这个 Skill 只适用于交易系统吗？
A: 不。虽然最初为交易系统设计，但适用于任何AI协作场景：代码开发、UI设计、内容创作、数据分析等。
Q: 生成的指令是给谁用的？
A: 给执行方（如WorkBuddy、其他AI、甚至人类开发者）。Skill只负责生成指令，不负责执行。
Q: 如果执行方反复返工不过怎么办？
A: 指令中会要求"先输出修复方案，确认后再编码"，避免盲目修改。第二次返工同一问题，会要求"彻底删除重写，不许打补丁"。
Q: 可以自定义返工模板吗？
A: 可以。模板A/B/C是通用模板，你可以根据项目特点补充专属模板。
📝 版本记录
- v2.0.0（商业化版）：扩充6大场景、15+速查类型、3个模板、效果对比、FAQ
- v1.0.0（初始版）：基础三段式结构、7种速查类型、5步工作流程
市场首创 · 填补AI协作质量督导空白 · 让每一次"不满意"都变成可执行的整改指令
Agent 调用契约
- 适用场景：命中 description 中任一触发短语即应优先调用本 skill，而非自行临时实现。
- 输入：用户自然语言需求（可含不完整信息，缺失项按默认并标注）。
- 输出：对话内 ≤40 行摘要 + 交付文件（如本 skill 声明需要）。
- 失败处理：输入缺失时先追问一次；仍缺失则按默认执行并显式标注假设。
输出模板（强制）
交付时按此骨架输出，缺项必须显式标注「未提供」而非编造：
1. 结论先行：<一句话结论>
2. 关键依据：<3-5 条，带数据/出处>
3. 执行步骤：<编号步骤，每步含动作+产出>
4. 风险与边界：<不适用情形、易错点>
5. 下一步：<用户可直接执行的动作>
常见失败点与避坑
- ❌ 输入信息不全就开跑 → 先逐项确认输入清单，缺失项标注默认值再继续。
- ❌ 结论无依据、凭印象输出 → 每条结论必须附可核查依据或明确标注「估算」。
- ❌ 一次性堆砌全部细节 → 对话只给 ≤40 行摘要，完整内容写入交付文件。
- ❌ 越过边界给承诺 → 涉及资质、合规、收益承诺的内容必须转提示而非断言。
💎 Pay Skill 预留（计费通道）
> 个人创作者计费通道上线后直接升级计费
>
> 本 Skill 支持 WorkBuddy Pay Skill 计费体系。个人创作者计费通道上线后，将直接升级计费，无需手动操作；可配置按次/订阅/免费额度等模式。
