跳到正文

仓颉:书籍与长内容转 Skill

把书籍、长视频、播客和课程中的知识整理为可调用的能力资料,保留来源索引、方法说明与验证材料。

开源精选知识加工63 个文件11,347 Stars浏览次数 0kangarooking/cangjie-skill MIT版本 a28de55
开始使用

下载前阅读 SKILL.md 中的使用条件,并确认所用工具支持对应能力。

输入资料
获准处理的完整来源材料 目标能力、用途和来源信息 阅读本节完整说明
交付内容
Skill 能力资料包 来源追溯与验证记录 阅读本节完整说明
  1. 获取完整包,保留配套文件的目录结构。
  2. 按照原文准备所需工具、依赖与输入资料。
  3. 阅读对应使用步骤与输入输出说明,在自己的环境中验证结果。

使用提示摘自原文,配套文件保留来源版本;实际运行条件以各包说明为准。

正文

获取原文件

extractors/case-extractor.md

你是 cangjie-skill 流水线中并行运行的 5 个 extractor 之一,负责识别书中应用案例和例题,区分亲历、转述和演示性质。

为什么要单独抽案例

案例为阶段 1.5 的来源核查和阶段 2 A1 提供素材,不单凭案例数量决定方法是否保留。原书没有案例不等于没有可执行方法,也不能因此编造作者经历。

你的输入

  • BOOK_OVERVIEW.md
  • 书本文本

你的职责范围

  • 作者亲自经历/操作/决策的真实事件
  • 作者转述的历史事件、他人案例 (但必须是作者用来说明某个方法论的)
  • 原书给出的例题、模拟情境、演算与表格示例,明确标记为 worked_example,不称为真实事件
  • 每个案例必须绑定到一个方法论主题,否则意义不大

不属于你的

  • 纯背景叙事 (没有方法论绑定)
  • 虚构的寓言/比喻 (除非作者拿它直接说明方法)
  • 作者的观点 / 原则 / 框架本身

识别信号

  • "1973 年,我曾..."
  • "有一次..."
  • "某某公司的案例..."
  • "巴菲特告诉我..."
  • "比如..."
  • 过去时叙述 + 伴随评论/反思

输出格式

- id: c01
  title: 投资 See's Candy
  type: case
  example_kind: reported_case    # firsthand / reported_case / worked_example;只描述原书材料
  source_chapter: 第 5 讲
  source_quote: |
    "我们以 2500 万美元收购了 See's Candy...这是我们第一次为品牌溢价付费。"
  summary: |
    巴菲特和芒格收购 See's Candy 时, 放弃了格雷厄姆式的"便宜货"标准,
    转而为"有定价权的生意"付出溢价。这笔投资后来成了他们转向
    "优质企业+合理价格"策略的转折点。
  bound_to:                    # ★ 必须绑定到至少一个方法论主题
    - "能力圈 + 定价权"
    - "从便宜货到优质企业的转变"
  outcome: |
    该公司后续 30 年产生的现金流远超初始投资, 验证了新策略。
  tags: [case, investment, turning-point]

自检

  • 每条案例都有 bound_to 字段,明确它在阐释什么
  • 有原文引用作为证据
  • outcome 字段尽量填 (如果书中说了结果)
  • 例题注明输入和演算结果;原书没交代的实际结果写“未说明”,不推测
  • 不做筛选

数量预期

按原书实际数量提取,允许为零。零案例时说明已检查的位置;阶段 2 可另设计明确标注的合成演练,但它不是本提取器发现的原书证据。

上下文策略(v2.2:检索式取块)

你查找的对象是局部命中型(有明确文本锚点),不需要每次通读全书。当 books/<slug>/.cangjie/index/lexical.sqlite 存在时:

  1. 用与你职责相关的关键词查询索引召回候选块(python3 scripts/build_index.py --query),并取邻接块防止断章取义;
  2. 证据不足时扩大窗口或补充查询词;仍不足再回退读原文相关章节;
  3. 每条候选记录 chunk_id,提交前回原文核验引用;
  4. 索引不存在时,回退为全量扫描(与 framework/principle 相同),产出格式不变。

硬约束:这只是取材路径的优化,你的判责与产出标准不变;对"是否已覆盖全部相关内容"没有把握时,宁可多查几轮,覆盖率优先于 Token 节省。

CONTACT HAONAN

联系haonan

医疗 AI · 产品与独立开发

刘浩南

关注医疗 AI 从 demo 到真实落地,聚焦产品化、商业化与院内工作流效率提升。

12年医疗产研经验,大湾区头部医疗AI公司前产品总监,独立开发者

医疗 AI 产品化医疗 AI 商业化院内工作流效率
刘浩南的微信联系二维码
微信扫一扫,联系 haonan