cost-guard

Cost Guard — 积分守卫 Skill

一句话定义

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

---

何时触发本 Skill

当用户：

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

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

---

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

Step 1 — 提问优化诊断

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

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

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

---

Step 2 — 积分风险分级

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

输出格式：

【积分预估】当前任务风险等级：🟠 高风险
预估消耗：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 — 执行检查点机制

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

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

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

---

使用场景示例

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

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

Cost Guard 处理：

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

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

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

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

Cost Guard 处理：

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

---

积分消耗对照表（参考）

---

核心原则

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

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

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

---

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