# Sy Practice

> 深度阅读·第五步。把

- Skill: `huanyu-hibiki/sy-practice` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add huanyu-hibiki/sy-practice`
- Raw SKILL.md: https://api.skillmd.com/api/skills/huanyu-hibiki/sy-practice/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Huanyu-Hibiki (https://skillmd.com/u/huanyu-hibiki)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/huanyu-hibiki/sy-practice

---


# sy-practice · 实践转化（卡片 → 书名\知识点 技能）

把"知道"变成"会做"——把书中知识固化为可反复调用的个人技能。

> **知识库根目录 `<知识库根>`**：① 本次会话用户显式指定 → ② 当前 Agent 打开的项目路径下有知识库标志（`阅读笔记/log.md` 或 `阅读笔记/_system/用户阅读报告.md`）→ ③ `~/.shendu-yuedu/config.json` 的 kb_root（问用户是否沿用）→ ④ 默认当前 Agent 打开的项目路径。权威定义见 `01-init/SKILL.md`「知识库根目录解析协议」。

## 前置
1. 读 `<知识库根>/阅读笔记/YYYY-MM/<书名>/知识卡片.md`（#4 全部卡片 C-001…）+ 知识网络图谱。
2. 读 Hub 取核心目标+应用场景。

## 技能定义标准（不达标不算技能）
1. **可触发**：有明确"当…时用此技能"
2. **可执行**：有具体步骤，不是"多读书"这种建议
3. **可验收**：执行后有可观察的"完成信号"
4. **可复用**：不绑单次场景，同类情境能反复调用
5. **原子化**：一技能做一事，复杂流程拆多个并标依赖

## 推理框架（Algorithm-of-Thoughts + CoV + 自校正）

**Step 1 卡片筛选（AoT 过滤）**
- 概念定义且无直接行动 → 不独立成技能，作其他技能的"知识背景"
- 方法工具 → 🔧工具型技能
- 洞察观点 → 🧠思维型技能（决策框架/检查清单）
- 常见误区 → ⚡决策型技能（"当…时，避免…"）
- 行动原则 → 直接转对应类型技能

**Step 2 技能萃取**
- 命名空间：`书名\动词化知识点`（"故事点估算"→"执行故事点估算"；知识点≤10汉字且动词化）
- 触发条件：从卡片 L1/L2 提适用场景，用"当…且…时"
- 步骤拆解：卡片方法→动作序列（每步≤2句，含可观察动作）
- 验收标准：从卡片"行动转化"提可验证结果

**Step 3 依赖与冲突**：A步骤引用B输出→A依赖B；A、B同工作流连续用→组合；A、B触发互斥→冲突。

**Step 4 CoV 四重验证**：①可执行性（不懂此书的人能否仅凭条目执行）②触发条件（太宽泛？真实场景能识别？）③验收（可观察可测量？禁"理解/掌握/熟悉"）④命名空间（格式对？已动词化？）

**Step 5 自校正**：过度抽象→拆可观察行为；步骤遗漏→补过渡；命名冲突→合并或差异化；脱离目标→删或降级"扩展"。

## 🔴 CHECKPOINT · 🛑 落盘前技能清单人审
7 点同步写入前，先向用户展示萃取结果一览表（技能名 / 类型 / 触发条件一句话 / 验收第一条）。用户确认 OK 才执行写入；用户要求增删改时回到 Step 2 调整后重新展示。

## 技能条目结构
```
### SK-001: 书名\执行XX
来源卡片 C-001 · 类型🔧/🧠/🗣️/📋/⚡ · 熟练度目标 初学/进阶/精通
触发条件：当…且…时

#### 执行步骤
1. …（每步≤2句，含可观察动作；复杂拆a/b/c；标关键决策点及判断标准）

#### 验收标准（≥3条，含1条反脆弱标准）
- [ ] 能…（可观察可测量）

#### 常见失败模式（3个，附早期预警信号）
1. 错误：… → 预警：…

#### 关联技能
前置依赖 / 后续组合 / 冲突技能（引用 SK-ID）
```

## 输出
1. **可执行 skill 资产写入 `<知识库根>/skills/<书名>/`**：
   - 单本索引：`<知识库根>/skills/<书名>/INDEX.md`（技能合集 + Mermaid 依赖图谱）
   - 单个技能：`<知识库根>/skills/<书名>/<skill-slug>/SKILL.md`
2. **同步追加到 `<知识库根>/skills/INDEX.md`**（跨书技能索引，⭐核心资产）——按 `书名\知识点` 索引，跨书汇总。
3. **同步回填阅读报告**：`<知识库根>/阅读笔记/_system/用户阅读报告.md` 的「已萃取技能索引（跨书累积）」章节，写入 skill 名称、路径、触发条件、来源书/章节。
4. **同步 Obsidian LLM Wiki 索引**：在 `wiki/index.md` 的手动 Skills/References 区或新建 `wiki/concepts/<书名>-技能索引.md` 中链接到 `skills/<书名>/INDEX.md`，确保后续可被 LLM Wiki 检索/调用。
5. **阅读侧记录仍写回对应书目目录**：`<知识库根>/阅读笔记/YYYY-MM/<书名>/实践转化.md`，记录本次从哪些知识卡片萃取了哪些技能；文件头带 OKF frontmatter（`type: 实践转化` / `title: <书名>·实践转化` / `tags: [深度阅读, <书名>]` / `timestamp`），回填阅读报告/wiki 索引的链接写法遵循 Hub 报告「知识库工具链」的链接规范。落盘后追加 `阅读笔记/log.md` 一条：`## [YYYY-MM-DD] practice | <书名>·萃取X个技能`。
6. 实践路线图（30-60-90天）：Week1-2 只练1个核心技能→Month1 扩2-3个→Month2-3 组合成工作流
7. 与 #3 实践钩子衔接表（每个钩子是否已转为某技能的首次执行）

### 同步失败处理（7 点同步的 fallback，绝不静默）
- 目标文件/目录不存在 → 先创建再写入（INDEX.md 带表头；技能目录带 SKILL.md 模板）
- 阅读报告缺「已萃取技能索引（跨书累积）」节 → 在报告末尾追加该节再回填
- `wiki/index.md` 有手动 Skills/References 区 → 链接进去；无该区但 wiki/ 存在 → 按输出点 4 的备选新建 `wiki/concepts/<书名>-技能索引.md`；wiki/ 整体不存在 → 跳过并在 `实践转化.md` 留一行注记，完成后告知用户
- 任一同步点写入失败（路径不可达/权限） → 🔴 停下告知用户哪点失败，其余点照常；禁止降级为"假装已同步"

## 约束
- **严格命名**：每个技能以 `书名\动词化知识点` 为标题，禁省书名
- **触发必须具体**：禁"需要估算时"，要"当…且…时"
- **验收必须可观察**：禁"理解/掌握/熟悉"
- **反脆弱标准 = 失败可见性**：验收中那 1 条反脆弱标准必须写明"技能失效/做错时会出现什么可观察信号"，让失败自动暴露而非无声无息（例："连续 3 次使用验收未达标 → 触发 #6 进化复盘"；禁写"效果好"式正向空话）
- **禁不可执行建议**："保持开放心态"必须转成"当他人反对时，先复述对方观点再回应"
- **诚实标推断**：步骤/验收基于推断标 `[推断]`
- **数量控制**：卡片>20张时只输出 P0 卡片对应技能，P1 标 `[扩展Skill，待P0熟练后解锁]`
- **不脱目标**：每个技能的触发或验收至少出现1次用户目标/场景关键词

## 人 × AI 分工
- **人**：把技能用到真实场景、反馈好不好用（喂给 #6）
- **AI**：筛选萃取、写技能条目、建依赖图、排路线图

## References

- `references/obsidian-skill-output-routing.md` — 深度阅读产物归位规则：阅读流程证据放 `<知识库根>/阅读笔记/`，sy-practice 萃取出的可执行 skill 放 `<知识库根>/skills/`，并同步 `skills/INDEX.md`、阅读报告「已萃取技能索引（跨书累积）」和 `wiki/index.md`。

## 下一步
技能要在真实使用中才变准——运行 **`sy-evolve`（自进化）**，按你的实际使用反馈迭代这些技能。说"迭代技能"或"技能不好用"即可。