📦 deps(skills): sync thirdparty skills
This commit is contained in:
ci[bot]
@@ -0,0 +1,102 @@
|
||||
# {{BOOK_TITLE}} — 整书理解 (阶段 0 产出)
|
||||
|
||||
> 本文档是 cangjie-skill 流水线的阶段 0 产出, 后续所有 extractor 和 skill 都以此为全局上下文。
|
||||
|
||||
## 基本信息
|
||||
|
||||
- **标题**: {{BOOK_TITLE}}
|
||||
- **作者**: {{AUTHOR}} <!-- 视频填 UP 主/讲者, 播客填主播 -->
|
||||
- **出版/发布时间**: {{YEAR}}
|
||||
- **内容类型**: {{ 书籍 / 视频转写 / 播客 / 课程 / 访谈 / 长文 }}
|
||||
- **版本来源**: {{SOURCE_FILE}}
|
||||
- **处理时间**: {{DATE}}
|
||||
|
||||
---
|
||||
|
||||
## 1. 结构 (Structural)
|
||||
|
||||
### 类型
|
||||
{{ 方法论 / 传记 / 哲学 / 实操手册 / ... }}
|
||||
|
||||
### 一句话主旨
|
||||
{{ 用一句话说清这本书在讲什么, 必须真的是一句 }}
|
||||
|
||||
### 骨架 (主要论点及其关系)
|
||||
|
||||
1. {{论点 1}}
|
||||
2. {{论点 2}}
|
||||
3. {{论点 3}}
|
||||
...
|
||||
|
||||
**论点之间的关系**: {{ 并列 / 递进 / 对比 / 反驳 / 层层深入 }}
|
||||
|
||||
### 作者要解决的核心问题
|
||||
{{ 作者写这本书是为了回答什么问题 }}
|
||||
|
||||
---
|
||||
|
||||
## 2. 解释 (Interpretive)
|
||||
|
||||
### 关键术语 (作者本人的用法)
|
||||
|
||||
| 术语 | 作者的定义 | 和常识用法的差异 |
|
||||
|---|---|---|
|
||||
| {{term}} | {{author's definition}} | {{what's different}} |
|
||||
|
||||
### 核心命题 (用自己的话)
|
||||
|
||||
1. {{命题 1}}
|
||||
2. {{命题 2}}
|
||||
...
|
||||
|
||||
### 论证链
|
||||
{{ 作者用什么证据/论证路径把这些命题串起来 }}
|
||||
|
||||
---
|
||||
|
||||
## 3. 批判 (Critical) ★
|
||||
|
||||
### 作者的时代局限
|
||||
- {{ ... }}
|
||||
|
||||
### 作者的立场盲点
|
||||
- {{ ... }}
|
||||
|
||||
### 未被证明的假设
|
||||
- {{ ... }}
|
||||
|
||||
### 最强反对意见
|
||||
{{ 如果有人要反驳这本书, 最强的论点会是什么 }}
|
||||
|
||||
> **以上批判会直接成为下游 skill 的 Boundary (B) 字段来源**
|
||||
|
||||
---
|
||||
|
||||
## 4. 应用潜力 (Applicability)
|
||||
|
||||
### 可 skill 化的内容
|
||||
- [ ] {{候选主题 1}}
|
||||
- [ ] {{候选主题 2}}
|
||||
...
|
||||
|
||||
### 不适合 skill 化的内容
|
||||
- {{ 这些内容会作为 example / 引用保留, 但不独立成 skill }}
|
||||
|
||||
### 预估 skill 数量
|
||||
**约 {{N}} 个** (最终由阶段 1.5 三重验证决定, 这里只是粗估)
|
||||
|
||||
### 优先级排序 (按"最能赋能普通人"的角度)
|
||||
1. {{top priority}}
|
||||
2. {{...}}
|
||||
|
||||
---
|
||||
|
||||
## ✅ 质量门检查
|
||||
|
||||
- [ ] 主旨能用一句话说清
|
||||
- [ ] 骨架列出 3–7 个一级论点
|
||||
- [ ] 关键术语词典 ≥5 条
|
||||
- [ ] 批判阶段列出 ≥3 条作者局限
|
||||
- [ ] 已向用户展示并得到确认
|
||||
|
||||
**用户确认时间**: {{ }}
|
||||
@@ -0,0 +1,73 @@
|
||||
# {{BOOK_TITLE}} — 精华 (DIGEST)
|
||||
|
||||
> 本文由 cangjie-skill 蒸馏生成,只呈现**通过三重验证**的方法论 — 不是全书摘要,是筛过水分的精华。
|
||||
> 想深入某个方法论时,点小节末尾的 skill 链接; 想看全貌,读 [INDEX.md](./INDEX.md)。
|
||||
> 作者: {{AUTHOR}} | {{YEAR}} | 全文约 {{WORD_COUNT}} 字, 预计阅读 {{N}} 分钟
|
||||
|
||||
## 这本书在讲什么
|
||||
|
||||
{{ 2-3 段: 一句话主旨的展开版。作者要解决什么问题、给出了什么答案、这个答案为什么值得听。
|
||||
来自 BOOK_OVERVIEW 的结构部分, 但要写成给读者看的流畅文字, 不是字段填空。}}
|
||||
|
||||
---
|
||||
|
||||
## {{一级论点 1 — 按书的骨架组织章节}}
|
||||
|
||||
{{ 本部分的引入: 这几个方法论共同回答什么问题 }}
|
||||
|
||||
### {{方法论 1 标题}}
|
||||
|
||||
**它解决什么问题**: {{ ... }}
|
||||
|
||||
**核心逻辑**: {{ 3-6 行, 用自己的话, 讲清这个方法论怎么运作、为什么有效 }}
|
||||
|
||||
**书中的用法**: {{ 最有代表性的 1 个案例, 讲清 问题→怎么用→结果 }}
|
||||
|
||||
> {{ 可选: 一句原文金句, ≤150 字 (英文 ≤100 词), 标注出处 }}
|
||||
|
||||
**什么时候会失效**: {{ 1-2 行边界 }}
|
||||
|
||||
→ 深入: [`{{skill-slug}}`](./{{skill-slug}}/SKILL.md)
|
||||
|
||||
### {{方法论 2 标题}}
|
||||
|
||||
{{ 同上结构 }}
|
||||
|
||||
---
|
||||
|
||||
## {{一级论点 2}}
|
||||
|
||||
{{ ... 重复上面的模式, 覆盖所有核心方法论 ... }}
|
||||
|
||||
---
|
||||
|
||||
## 陷阱与反例
|
||||
|
||||
{{ 来自 counter-examples 池: 作者警告的失败模式。
|
||||
每条讲清: 陷阱是什么 → 为什么人会掉进去 (机制) → 预警信号。
|
||||
3-6 条, 挑最有杀伤力的。}}
|
||||
|
||||
---
|
||||
|
||||
## 作者的局限 (读这本书要打的折扣)
|
||||
|
||||
{{ 来自阶段 0 批判部分: 时代局限 / 立场盲点 / 未证明的假设 / 最强反对意见。
|
||||
2-4 条。只报喜不报忧的精华是软文, 不是蒸馏。}}
|
||||
|
||||
---
|
||||
|
||||
## 关键术语速查
|
||||
|
||||
| 术语 | 作者的用法 | 和常识的差异 |
|
||||
|---|---|---|
|
||||
| {{term}} | {{definition}} | {{distinction}} |
|
||||
|
||||
完整词典见 [GLOSSARY.md](./GLOSSARY.md)。
|
||||
|
||||
---
|
||||
|
||||
## 如果只带走三句话
|
||||
|
||||
1. {{ 最核心的一条 }}
|
||||
2. {{ ... }}
|
||||
3. {{ ... }}
|
||||
@@ -0,0 +1,86 @@
|
||||
# {{BOOK_TITLE}} — Skill Index
|
||||
|
||||
> 本书由 cangjie-skill 蒸馏, 共产出 **{{N}}** 个 skills。
|
||||
> 处理时间: {{DATE}}
|
||||
|
||||
## 关于这本书
|
||||
|
||||
- **作者**: {{AUTHOR}}
|
||||
- **出版年**: {{YEAR}}
|
||||
- **一句话主旨**: {{ONE_LINE_THEME}}
|
||||
- **整书理解**: 见 [BOOK_OVERVIEW.md](./BOOK_OVERVIEW.md)
|
||||
- **精华长文** (不读全书看这篇): [DIGEST.md](./DIGEST.md)
|
||||
- **术语词典**: [GLOSSARY.md](./GLOSSARY.md)
|
||||
|
||||
---
|
||||
|
||||
## Skill 列表 (按主题分组)
|
||||
|
||||
### {{主题 1}}
|
||||
|
||||
- [`{{skill-slug-1}}`](./{{skill-slug-1}}/SKILL.md) — {{一句话描述}}
|
||||
- [`{{skill-slug-2}}`](./{{skill-slug-2}}/SKILL.md) — {{一句话描述}}
|
||||
|
||||
### {{主题 2}}
|
||||
|
||||
- [`{{skill-slug-3}}`](./{{skill-slug-3}}/SKILL.md) — {{一句话描述}}
|
||||
|
||||
---
|
||||
|
||||
## 引用图
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
A[skill-a] -->|depends-on| B[skill-b]
|
||||
A -.->|contrasts-with| C[skill-c]
|
||||
B ===>|composes-with| D[skill-d]
|
||||
```
|
||||
|
||||
图例:
|
||||
- `-->` depends-on
|
||||
- `-.->` contrasts-with
|
||||
- `===>` composes-with
|
||||
|
||||
---
|
||||
|
||||
## 推荐学习顺序
|
||||
|
||||
(从依赖图的叶子节点开始, 向上)
|
||||
|
||||
1. **{{skill-a}}** — 最基础, 没有前置
|
||||
2. **{{skill-b}}** — 依赖 skill-a
|
||||
3. **{{skill-c}}** — 依赖 skill-a, 与 skill-b 互补
|
||||
...
|
||||
|
||||
---
|
||||
|
||||
## 安装使用
|
||||
|
||||
本目录是构建产物, 宿主不会从这里加载 skill。要让 agent 真正调用, 把 skill 目录复制到宿主的 skills 目录:
|
||||
|
||||
```bash
|
||||
# 用户级 (所有项目可用)
|
||||
cp -r {{skill-slug-1}} ~/.claude/skills/
|
||||
|
||||
# 或项目级
|
||||
cp -r {{skill-slug-1}} <project>/.claude/skills/ # Claude Code
|
||||
cp -r {{skill-slug-1}} <project>/.cursor/skills/ # Cursor
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 接入 darwin-skill
|
||||
|
||||
所有 skill 均带有 `test-prompts.json` (darwin-skill 兼容格式), 可直接接入自动进化:
|
||||
|
||||
```
|
||||
darwin evolve books/{{book-slug}}/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 审计轨迹
|
||||
|
||||
- 候选单元池: [candidates/](./candidates/)
|
||||
- 被淘汰的候选 (含原因): [rejected/](./rejected/)
|
||||
- BOOK_OVERVIEW: [BOOK_OVERVIEW.md](./BOOK_OVERVIEW.md)
|
||||
@@ -0,0 +1,121 @@
|
||||
---
|
||||
name: {{skill-slug}}
|
||||
description: |
|
||||
{{何时调用 + 何时不调用 + 关键 trigger 信号, ≤300 字}}
|
||||
source_book: 《{{BOOK_TITLE}}》 {{AUTHOR}}
|
||||
source_chapter: {{章节}}
|
||||
tags: [{{tag1}}, {{tag2}}]
|
||||
related_skills: [] # 阶段 3 填充
|
||||
---
|
||||
|
||||
<!--
|
||||
填写说明 (生成最终 skill 时删除本注释块):
|
||||
- description: 基于 A2 段浓缩, ≤300 字, 必须含"何时调用 + 何时不调用 + 关键 trigger 信号"。
|
||||
好例: "用户在纠结一个决策、列举正面理由却理不出头绪时;或在问'怎么做 X 才能成功'时。不适用于: 纯信息查询、日常琐碎选择。"
|
||||
关键 trigger 词建议中英双写, 提高英文提问场景的触发准确率。
|
||||
- source_chapter: 书填章节/页码; 视频填时间戳/分 P; 播客填集数。
|
||||
- source_book / tags / related_skills 为审计与链接用的扩展字段, 宿主加载 skill 时只读 name + description。
|
||||
-->
|
||||
|
||||
# {{Skill Title}}
|
||||
|
||||
## R — 原文 (Reading)
|
||||
|
||||
> {{原文引用, ≤150 字 (英文 ≤100 词), 必须标注章节/页码/时间戳}}
|
||||
>
|
||||
> — {{AUTHOR}}, {{CHAPTER}}
|
||||
|
||||
---
|
||||
|
||||
## I — 方法论骨架 (Interpretation)
|
||||
|
||||
{{ 用自己的话重写, 5-15 行。
|
||||
读完这段, 一个没读过原书的人应当能理解这个方法论在做什么。
|
||||
禁止照搬原文, 禁止堆砌修辞。}}
|
||||
|
||||
---
|
||||
|
||||
## A1 — 书中的应用 (Past Application)
|
||||
|
||||
### 案例 1: {{案例名}}
|
||||
- **问题**: {{作者遇到了什么}}
|
||||
- **方法论的使用**: {{作者怎么用这个方法论思考}}
|
||||
- **结论**: {{得出了什么}}
|
||||
- **结果**: {{实际发生了什么}}
|
||||
|
||||
### 案例 2 (如有)
|
||||
...
|
||||
|
||||
---
|
||||
|
||||
## A2 — 触发场景 (Future Trigger) ★
|
||||
|
||||
### 用户会在什么情境下需要这个 skill?
|
||||
|
||||
1. {{场景 1 — 具体到可识别的情况}}
|
||||
2. {{场景 2}}
|
||||
3. {{场景 3}}
|
||||
|
||||
### 语言信号 (用户的话里出现这些就应激活)
|
||||
|
||||
- "{{典型措辞 1}}"
|
||||
- "{{典型措辞 2}}"
|
||||
- "{{典型措辞 3}}"
|
||||
|
||||
### 与相邻 skill 的区分
|
||||
|
||||
- 与 `{{related-skill-a}}` 的区别: {{ ... }}
|
||||
- 与 `{{related-skill-b}}` 的区别: {{ ... }}
|
||||
|
||||
---
|
||||
|
||||
## E — 可执行步骤 (Execution)
|
||||
|
||||
当 skill 被激活后, agent 应按以下步骤执行:
|
||||
|
||||
1. **{{步骤 1}}**
|
||||
- 完成标准: {{如何判断这一步已完成}}
|
||||
|
||||
2. **{{步骤 2}}**
|
||||
- 完成标准: {{ ... }}
|
||||
- 判停条件: 若 {{X}} 则跳到步骤 {{N}}
|
||||
|
||||
3. **{{步骤 3}}**
|
||||
- 完成标准: {{ ... }}
|
||||
|
||||
---
|
||||
|
||||
## B — 边界 (Boundary) ★
|
||||
|
||||
### 不要在以下情况使用此 skill
|
||||
|
||||
- {{反场景 1 — 为什么不适用}}
|
||||
- {{反场景 2}}
|
||||
|
||||
### 作者在书中警告的失败模式
|
||||
|
||||
- {{ 来自 counter-example-extractor 的对应反例 }}
|
||||
|
||||
### 作者的盲点 / 时代局限
|
||||
|
||||
- {{ 来自阶段 0 批判阶段 }}
|
||||
|
||||
### 容易混淆的邻近方法论
|
||||
|
||||
- {{ ... }}
|
||||
|
||||
---
|
||||
|
||||
## 相关 skills (阶段 3 填充)
|
||||
|
||||
- depends-on: {{}}
|
||||
- contrasts-with: {{}}
|
||||
- composes-with: {{}}
|
||||
|
||||
---
|
||||
|
||||
## 审计信息
|
||||
|
||||
- **验证通过**: V1 ✓ / V2 ✓ / V3 ✓
|
||||
- **测试通过率**: {{%}} (详见 test-prompts.json)
|
||||
- **蒸馏时间**: {{DATE}}
|
||||
@@ -0,0 +1,52 @@
|
||||
{
|
||||
"skill": "{{skill-slug}}",
|
||||
"version": "0.1.0",
|
||||
"source_book": "{{BOOK_TITLE}} — {{AUTHOR}}",
|
||||
"darwin_compatible": true,
|
||||
"test_cases": [
|
||||
{
|
||||
"id": "should-trigger-01",
|
||||
"type": "should_trigger",
|
||||
"prompt": "{{用户的典型话语 1 — 正面场景}}",
|
||||
"expected_behavior": "应激活 {{skill-slug}}, 并 {{期望的具体动作}}",
|
||||
"notes": "{{为什么这是正面场景}}"
|
||||
},
|
||||
{
|
||||
"id": "should-trigger-02",
|
||||
"type": "should_trigger",
|
||||
"prompt": "{{用户的典型话语 2}}",
|
||||
"expected_behavior": "...",
|
||||
"notes": "..."
|
||||
},
|
||||
{
|
||||
"id": "should-trigger-03",
|
||||
"type": "should_trigger",
|
||||
"prompt": "{{用户的典型话语 3}}",
|
||||
"expected_behavior": "...",
|
||||
"notes": "..."
|
||||
},
|
||||
{
|
||||
"id": "should-not-trigger-01",
|
||||
"type": "should_not_trigger",
|
||||
"prompt": "{{诱饵 1 — 看似相关但实际不该调用}}",
|
||||
"expected_behavior": "不应激活本 skill, 因为 {{理由}}",
|
||||
"notes": "诱饵: {{这是什么类型的诱饵}}"
|
||||
},
|
||||
{
|
||||
"id": "should-not-trigger-02",
|
||||
"type": "should_not_trigger",
|
||||
"prompt": "{{诱饵 2 — 应触发同书另一个 skill 的场景}}",
|
||||
"expected_behavior": "不应激活本 skill, 应激活 {{sibling-skill-slug}}",
|
||||
"notes": "跨 skill 混淆诱饵 (硬性要求至少 1 条): 防止同书 skill 互相抢调用"
|
||||
},
|
||||
{
|
||||
"id": "edge-01",
|
||||
"type": "edge_case",
|
||||
"prompt": "{{边界模糊场景}}",
|
||||
"expected_behavior": "{{期望的合理判断 — 可能是调用, 可能是不调用, 但要说清为什么}}",
|
||||
"notes": "边界: {{为什么这是边界}}"
|
||||
}
|
||||
],
|
||||
"minimum_pass_rate": 0.8,
|
||||
"notes": "至少 3 条 should_trigger + 2 条 should_not_trigger + 1 条 edge_case。全部 should_not_trigger 必须通过 (诱饵容错为 0), 且其中至少 1 条是同书兄弟 skill 的场景 (跨 skill 混淆测试)。"
|
||||
}
|
||||
Reference in New Issue
Block a user