cost-guard

积分守卫 Skill — 在执行任何高消耗任务前，自动完成提问优化、积分预估、风险拦截、替代方案推荐， 帮助用户以最少积分完成有实际产出的任务。适用于 WorkBuddy 平台积分管理场景。

Cost Guard — 积分守卫 Skill

一句话定义

在执行任何可能大量耗积分的任务前，先做「提问诊断 → 积分预估 → 风险拦截 → 推荐最优路径」，确保每一分积分都有实质产出。

---

何时触发本 Skill

当用户：

• 提出涉及 文件处理（PDF/Word/Excel）、批量生成、Agent 多步任务、Skill 调用 的请求
• 明确提到 积分、省钱、效率
• 上一次任务消耗大量积分但无实质产出
• 任务描述模糊，可能导致 AI 猜测意图、反复尝试

立即加载本 Skill 并按以下流程处理。

---

执行流程（AI 必须按顺序完成）

Step 1 — 提问优化诊断

在任何工具调用之前，对用户的需求做一次结构化拆解，输出以下信息：

text

【需求拆解】
- 目标产出物：（具体文件/内容是什么？）
- 输入材料：（有哪些文件？格式？）
- 质量标准：（精确匹配还是大致即可？）
- 是否有截止时间压力：（影响是否采用快速路径）
- 关键未知点：（有哪些信息不清楚，可能导致猜测？）

如果「目标产出物」不明确，必须先用一句话向用户确认，再执行任何工具。

---

Step 2 — 积分风险分级

按任务类型自动评级（AI自动判断，无需用户操作）：

风险等级	典型场景	估算积分消耗	处理策略
🟢 低风险	文字生成、问答、简单代码	10–50 积分	直接执行
🟡 中风险	单文件读取+生成Word、简单Python脚本	50–200 积分	说明方案后执行
🟠 高风险	调用专用Skill、多步Agent、PDF OCR	200–800 积分	必须先确认方案
🔴 极高风险	叠加多个Skill、大文件循环处理、超过5步Agent链	800+ 积分	强制拦截，提供替代路径

输出格式：

text

【积分预估】当前任务风险等级：🟠 高风险
预估消耗：300–600 积分
主要消耗来源：PDF扫描版OCR + Agent多步循环

---

Step 3 — 高危模式拦截清单

以下任何一条触发，必须在执行前向用户明确告知并等待确认：

⛔ 拦截条件

1. 技能叠加 — 一个任务触发了 2 个以上专用 Skill（exam-evaluator、exam-dashboard 等）

   • 处置：只保留最相关的一个，其余用基础工具替代

2. 扫描版PDF — 用户提供的 PDF 是扫描图片版（非文本层）

   • 处置：先用小范围测试（读1页）判断是否需要 OCR，再决定是否全量处理

3. Agent循环无终止条件 — 任务描述中没有明确"完成标准"

   • 处置：要求用户明确「什么样的输出算完成」

4. 跨对话续接任务 — 上下文已丢失，需要重新加载大量背景信息

   • 处置：要求用户提供关键信息摘要，避免 AI 重新搜索

5. "帮我做一个完整的XXX" — 模糊的大型任务请求

   • 处置：先输出任务分解清单，让用户确认范围再执行

---

Step 4 — 最优路径推荐

针对常见高消耗场景，推荐已验证的低成本替代方案：

场景A：从 PDF 提取内容生成 Word（如题库生成）

❌ 高消耗路径：调用 exam-dashboard / exam-evaluator Skill
✅ 低成本路径：

1. 用 Read 工具读取 PDF（文本层直接读，无需 OCR）
2. 用 Python python-docx 库直接生成 Word 文档
3. 一次完成，无需多步 Agent 循环 预估节省：70–80% 积分

场景B：批量处理多个文件

❌ 高消耗路径：对每个文件分别发起请求
✅ 低成本路径：

1. 先读取所有文件目录，确认文件格式一致
2. 写一个 Python 脚本批量处理
3. 一次执行，一次产出 预估节省：60% 积分

场景C：生成可视化报告

❌ 高消耗路径：exam-dashboard 自动生成20+图表
✅ 低成本路径：

1. 明确用户需要哪3个最关键图表
2. 用 show_widget 直接渲染 SVG/Chart.js
3. 按需追加，而非一次全量 预估节省：50–70% 积分

场景D：内容生成（PPT/报告/文章）

❌ 高消耗路径：触发 ppt-generator、ppt-workflow 等叠加
✅ 低成本路径：

1. 先用文字描述大纲（不调用任何 Skill）
2. 确认结构后，用 powerpoint-pptx Skill 一次性生成 预估节省：40% 积分

---

Step 5 — 执行检查点机制

任务开始执行后，每完成一个关键节点，输出一行进度确认：

text

✅ [节点1] 文件读取完成，共提取 47 道题目
✅ [节点2] 章节分类完成，覆盖 8 个章节
⏳ [节点3] Word文档生成中...

如果某个节点失败，立即停止并报告，不继续重试消耗积分。

---

使用场景示例

示例1 — 用户请求题库生成

用户说： "帮我把这6份试卷做成按章节分类的Word题库"

Cost Guard 处理：

text

【需求拆解】
- 目标产出物：Word文档，含题目+答案+解析，按章节分类
- 输入材料：6份PDF试卷（需确认是文本版还是扫描版）
- 关键未知点：PDF是否有文字层？

【积分预估】风险等级：🟠 高风险（若为扫描版则升至🔴）
推荐路径：Read读取→Python提取→python-docx生成，预估 150–250 积分

是否按此路径执行？（Y/N）

示例2 — 用户说"积分不够了"

Cost Guard 处理：

text

好的，切换到「省积分模式」：
1. 本次对话只做一件事，做完再说
2. 不调用任何专用Skill，用基础工具
3. 每步完成后确认，不自动继续下一步
请说明当前最需要完成的那一件事是什么？

---

积分消耗对照表（参考）

操作类型	典型积分消耗
纯文字问答	5–20
读取单个文本文件	10–30
生成单个Word/PPTX文档	50–150
调用一个专用Skill	100–400
PDF扫描版OCR（每页）	20–50
Agent多步循环（每轮）	50–200
叠加多Skill复杂任务	500–2000+

---

核心原则

一次对话，一个产出，最短路径，先确认再执行。

本 Skill 不阻止用户使用任何功能，只确保用户在消耗大量积分之前，清楚地知道：

1. 将消耗多少积分
2. 产出是什么
3. 是否有更便宜的路径

---

Cost Guard v1.0 — 由 WorkBuddy 自动生成，基于积分浪费场景深度复盘