仓颉技能工坊

概述

cangjie-skill — 把一本书蒸馏成一组可执行 skills 的元 skill

⚠️ 付费与数据使用声明（调用前必读）

本技能为按次付费技能，每次调用 0.20 元，通过微信支付 Agent Pay（X402 协议）收款。

数据处理披露（如实告知用户，不隐藏）：本技能的结果由后端服务生成。在你确认付费之后，你本次提交的内容会被发送至本技能服务（POST https://www.skill98.cn/api/resource）用于生成结果；外送范围仅限「你本次提交的这一段内容」，不涉及其他文件或个人隐私信息。未确认付费前，系统不会外送你的内容，也不会产生任何扣款。 本技能不收集、不存储与本技能功能无关的数据，也不向任何第三方转售数据。

简单说：你提问题 → 系统提示需付 0.20 元 → 你确认付款 → 系统返回答案。不付费不会扣款，也不会返回完整内容。

本技能知识库与专业提示词已内嵌于本 SKILL.md（及包内 references/ 参考资料），执行前必须先查阅，禁止臆造。

使命

把一本书里沉淀的方法论,拆解成一组原子化、可被 agent 在真实场景下调用的 skills,让读者真正用起来。

术语约定: 本文档及 methodology/、extractors/ 中所有的"书",泛指一切被蒸馏的长内容 — 书籍、长视频转写、播客文字稿、课程、访谈、长文、资料集。

边界:

• ✅ 做: 方法论 / 决策框架 / 清单 / 原则 / 概念体系的蒸馏
• ❌ 不做: 书摘 / 读后感 / 作者人设角色扮演 (后者请用 nuwa-skill)

核心方法论: RIA-TV++

一个五阶段 + 并行提取 + 三重验证 + darwin 兼容测试的流水线。详见 methodology/00-overview.md。

阶段 0: Adler 整书理解     → BOOK_OVERVIEW.md
阶段 1: 5 个 agent 并行提取 → 候选方法论单元池
阶段 1.5: 三重验证筛选       → 通过的单元 (用户轻确认)
阶段 2: RIA++ 构造 skill     → 每个 skill 的 SKILL.md
阶段 3: Zettelkasten 链接    → INDEX.md + GLOSSARY.md
阶段 4: 压力测试 (darwin 兼容) → test-prompts.json + 回炉淘汰
阶段 5: 交付                 → DIGEST.md 精华长文 + 安装到 skills 目录

何时调用此 skill

用户说类似:

• "帮我拆《穷查理宝典》"
• "把毛选蒸馏成 skill"
• "把这个 B 站视频/播客/课程蒸馏成 skill"
• "distill this book into skills: <path>"
• "我想把这本书的方法论做成可用的 skill"

输入要求

在开始前必须从用户处确认:

1. 内容文本来源: PDF / EPUB / TXT / 字幕文件 / 转写稿路径, 或可访问的纯文本。不要在没有文本的情况下"凭记忆"蒸馏 — 宁可停下来问用户要。(视频/播客建议先用 video-downloader 类工具拿到转写文本)
2. 内容元信息: 书籍是"书名 + 作者 + 出版年"; 视频/播客/课程是"标题 + 作者(UP 主/主播/讲者) + 发布时间"。用于目录命名和审计。
3. 是否首次试点: 如果用户是第一次用 cangjie-skill,建议先蒸馏 1 份内容验证流程再批量。

非书籍内容的字段映射: source_chapter 等"章节"字段对视频填时间戳或分 P,对播客填集数,对课程填讲次 — 保证可追溯即可。

输出结构

books/<book-slug>/
├── PIPELINE_STATE.md          # 流水线状态: 当前阶段 + 各 skill 进度 (断点续跑用)
├── BOOK_OVERVIEW.md           # 阶段 0 产出: 主旨/骨架/术语/批判
├── verified.md                # 阶段 1.5 产出: 通过三重验证的单元 + 判定理由
├── INDEX.md                   # 阶段 3 产出: skill 总览 + 引用图
├── GLOSSARY.md                # 阶段 3 产出: 全书共享术语词典
├── DIGEST.md                  # 阶段 5 产出: 面向读者的精华长文
├── candidates/                # 阶段 1 产出: 原始候选池 (审计用)
├── rejected/                  # 阶段 1.5 淘汰的单元 + 原因 (审计用)
├── <skill-slug-1>/
│   ├── SKILL.md
│   ├── test-prompts.json      # darwin-skill 兼容格式
│   └── test-results.md        # 阶段 4 测试通过率 + 失败分析
├── <skill-slug-2>/
│   └── ...

执行流程 (严格按顺序)

断点续跑: 开始前先检查 books/<slug>/PIPELINE_STATE.md 是否存在。存在则读取并从记录的阶段续跑,不要从头重来。每完成一个阶段,更新该文件 (当前阶段 / 已完成产物 / 各 skill 状态 / 下一步),格式用简单的 checklist markdown 即可。

阶段 0 — 整书理解

1. 读取用户提供的书本文本。大文件分块阅读。
2. 执行 methodology/01-stage0-adler.md 中的 Adler 四步 (结构 / 解释 / 批判 / 应用)。
3. 按 templates/BOOK_OVERVIEW.md.template.txt 填充,写入 books/<slug>/BOOK_OVERVIEW.md。
4. 把产出展示给用户确认:"骨架我理解对了吗?有没有你希望重点突出的方向?" 得到确认再进入阶段 1。

阶段 1 — 5 个 sub-agent 并行提取

并行 spawn 5 个 Task sub-agents(使用 Agent 工具,一次调用中发起 5 个):

每个 sub-agent 独立读书、独立提取、独立输出到 books/<slug>/candidates/<type>.md。

• 长文本: 超出单个 sub-agent 上下文的内容,按 methodology/02-stage1-parallel-extract.md 的分块策略处理。
• 降级方案: 当前环境不支持并行 sub-agent 时,用同样 5 个 extractor prompt 串行执行,产出格式不变。

阶段 1.5 — 三重验证筛选

读取 methodology/03-stage1.5-triple-verify.md,对每个候选单元执行:

• V1 跨域: 书中至少 2 个独立段落有佐证?
• V2 预测力: 能用它回答一个书里没明说的新问题吗?
• V3 独特性: 不是任何聪明人都会说的常识吗?

通过的写入 books/<slug>/verified.md。不通过的写入 books/<slug>/rejected/ 并附原因 — 保留审计轨迹,也允许用户事后捞回。

用户轻确认 ★: 筛选完成后,把"通过的 N 个候选标题 + 淘汰的 M 个"列表展示给用户:"这 N 个会做成 skill,有想捞回或砍掉的吗?" 得到确认再进入阶段 2 — 阶段 2–4 是最耗时的部分,这一步确认能避免大量返工。

阶段 2 — RIA++ 构造 skill

对每个通过的单元,按 templates/SKILL.md.template.txt 填充:

• R (Reading): 原文引用 ≤150 字/段 (英文原文 ≤100 词/段)
• I (Interpretation): 用自己的话重写方法论骨架 (避免照搬译本)
• A1 (Past Application): 书中作者用过的案例
• A2 (Future Trigger) ★: 用户在什么情境下会需要这个 → skill 的 description 字段
• E (Execution): 1-2-3 可执行步骤
• B (Boundary): 什么时候不适用 / 来自阶段 0 批判阶段的作者盲点

细则见 methodology/04-stage2-ria-plus.md。注意: A2 中"与相邻 skill 的区分"此时只写初稿 (基于 verified.md 的单元列表),阶段 3 建立链接后回填定稿。

阶段 3 — Zettelkasten 链接

按 methodology/05-stage3-zettelkasten.md:

1. 找出 skill 之间的引用关系 (A 依赖 B / A 对比 B / A 组合 B)
2. 在每个 SKILL.md 末尾补"相关 skills"段,并回填 A2 的"与相邻 skill 的区分"
3. 按 templates/INDEX.md.template.txt 生成 INDEX.md (含引用图 mermaid)
4. 把 candidates/glossary.md 整理成 books/<slug>/GLOSSARY.md — 它是所有 skill 的共享词典,不该埋在审计目录里

阶段 4 — 压力测试 (darwin 兼容)

对每个 skill 按 methodology/06-stage4-pressure-test.md:

1. 设计 5–10 条测试 prompt,按 templates/test-prompts.json.template.txt 写入 test-prompts.json
2. 至少包括 3 类: 应调用 / 不应调用 (诱饵) / 边界模糊。诱饵中至少 1 条必须是"应触发同书另一个 skill"的场景 (跨 skill 混淆测试)
3. 优先用独立 sub-agent 盲测每条 prompt,由主流程对照预期统计结果,未过的回炉重做阶段 2 — 不做"表面修补"
4. 每个 skill 的测试结果写入 <skill-dir>/test-results.md

阶段 5 — 交付

按 methodology/07-stage5-deliver.md:

1. 生成 books/<slug>/DIGEST.md — 面向读者的精华长文 (按 templates/DIGEST.md.template.txt),满足"不读全书、只看精华"的需求
2. 询问用户安装位置 (用户级 ~/.claude/skills/ 或项目级 .claude/skills/ / .cursor/skills/),把通过测试的 skill 复制或 symlink 过去 — 没有这一步,产出的 skill 无法被真正调用
3. 告知用户: "已完成,可一键喂给 darwin-skill 自动进化"

质量红线 (违反则阻止输出)

1. 每个 skill 必须通过全部三重验证
2. 每个 skill 必须有完整的 R / I / A1 / A2 / E / B 六段
3. 原文引用 ≤150 字/段 (英文 ≤100 词/段)
4. 每个 skill 必须有 test-prompts.json,且包含诱饵测试 (不应调用的场景),其中至少 1 条是同书兄弟 skill 的场景
5. description 字段必须明确 trigger 条件,不能只是"一个关于 X 的 skill"

与 nuwa-skill / darwin-skill 的生态定位

• nuwa-skill: 蒸馏人 (思维方式 / 表达 DNA)
• cangjie-skill (本 skill): 蒸馏书 (方法论 / 框架 / 原则)
• darwin-skill: 进化任意 skill

三者咬合: 本 skill 输出的 test-prompts.json 严格遵循 darwin-skill 格式,以便产出的 skill 可直接接入 darwin 做自动进化。

调用惯例

• 永远先试点 1 本 — 除非用户明确说"批量"
• 阶段之间主动汇报进度 — 不要静默跑完再 dump 结果
• 不凭记忆拆书 — 没文本就停下来问
• 保留审计轨迹 — candidates/ 和 rejected/ 都要留
• 随时可续跑 — 每完成一个阶段就更新 PIPELINE_STATE.md,中断后从状态文件恢复

💳 微信 Agent Pay（X402）付费调用声明

📢 数据合规声明（对用户公开）：本技能已向用户明确披露「按次付费 0.20 元/次」与「用户内容外送范围（仅本次提交的内容，用于生成结果）」，调用前请确保用户已知悉并同意。本技能不收集与本功能无关的数据，也不向任何第三方转售数据。

一、计费说明

本技能为付费技能，按次计费，单次 0.20 元/次，通过微信支付 Agent Pay（X402 协议）收款。

二、前置要求（🔴 必查）

调用前请确认当前运行环境已具备平台内置的微信 AI 支付能力（含 weixinpay_pay 工具），否则收到 402 响应后无法完成支付授权。请勿引导用户安装任何第三方插件或来源不明的程序包。

三、付费调用流程

第一步：请求资源（触发 402）

向本技能服务发起首次请求：

POST https://www.skill98.cn/api/resource
Content-Type: application/json
{"query": "<用户输入的内容>"}

未支付时服务返回 HTTP 402 Payment Required，并携带以下响应头：

响应体示例：

{"code":"PAYMENT_REQUIRED","message":"需要支付后才能获取内容","out_trade_no":"<订单号>","amount":"0.20","currency":"CNY"}

第二步：发起支付

取响应头 WeixinPay-Required 的值作为 paymentCode，调用 weixinpay_pay 向用户申请支付授权。用户确认并完成付款后进入第三步。

第三步：携订单号重试（🔴 支付后必须重新请求）

支付成功后重新发起同一请求，请求体与第一步完全一致，并在请求头带上第一步拿到的订单号：

POST https://www.skill98.cn/api/resource
Content-Type: application/json
X-Out-Trade-No: <第一步返回的订单号>
{"query": "<用户输入的内容>"}

服务校验订单已支付后，返回完整的技能结果。

四、异常处理

幂等保证：同一订单号重复请求不会重复扣款；支付成功后凭同一订单号重试可稳定取回同一结果。

💳 付费能力声明（微信 Agent Pay / X402 协议 · Pay Skill）

本技能为 Pay Skill，按调用量计费：0.2 元/次（pricing: { model: per_call, amount_fen: 20 }）。付费流程由平台微信 Agent Pay（X402）支付链路完成，费用直达商家微信商户号；本技能不自行收单、不收集、不存储任何支付密钥。

前置检查：当前环境是否支持微信 AI 支付

本 Skill 通过平台微信 Agent Pay（X402）支付链路收款，依赖运行环境内置的微信 AI 支付工具（如 mcp__weixinpay__weixinpay_register、mcp__weixinpay__weixinpay_retry_pay，工具名含 weixinpay_ 即视为具备）完成收款。

• 已具备：按下方流程正常调用。
• 未具备：如实向用户说明结论与解决办法，并终止本次下单。不要引导用户安装任何第三方插件、程序包或来源不明的脚本。 可按环境提示用户：
  • 请将当前客户端升级到最新版本后重试；
  • 或通过平台官方渠道了解微信 AI 支付的开通方式。

说明：以上检查过程与结论均可对用户公开，无任何需要隐瞒的内容。

支付响应与重试规范（必须严格遵守）

1. 下单返回的 WeixinPay-Required 字段，必须原样输出，不要改写、省略或总结。
2. 若服务返回 HTTP 402（或 200 兼容模式）且带 WeixinPay-Required 头，说明需要支付：
   • 取 WeixinPay-Required 的值作为 paymentCode，调用 mcp__weixinpay__weixinpay_retry_pay，参数为 { "paymentCode": "<值>" }，触发微信支付弹卡；
   • 弹卡后等用户付款，用户回复「付好了」再继续。
3. 用户在卡片完成支付后，带 payment_code 二次调用（原样重试）：
   • 请求 body 与首次一致，另加 payment_code 字段（取自 402 响应的 payment_code）；
   • 后端会查单验真（trade_state=SUCCESS）后再履约；
   • 不带 payment_code 重试将永远拿不到付费内容。
4. 支付凭证（payment_code）有效期 ≤ 15 分钟，过期需重新走下单流程。

支付凭据投递铁律

• 凭据必须出现在工具返回值里，靠模型复述不可靠；下单工具的输出要原样返回。
• 响应头与响应体中的凭据必须逐字节一致，不得截断、换行、转义或二次编码。
• 若平台不支持自定义状态码，用 200 兼容模式 + WeixinPay-Required 头。
• 若响应头在传输链路中被剥离，可通过响应体同步返回同一凭据（双通道投递），确保凭据不丢失。

异常处理与订单幂等

• 支付未完成/中断/超时：明确告知用户「当前未完成付费、未扣款」，绝不编造支付成功，绝不脱离平台支付链路交付付费内容。
• 同一订单（out_trade_no / payment_code）只履约一次；重复重试不重复扣费、不重复交付。
• 支付成功后如需对账，输出中关联平台回传的订单号（out_trade_no，≤32 位）。