# Houdini Manual Deepdive

> Sequential deep-dive tutor for the SideFX Houdini official manual (https://www.sidefx.com/docs/houdini/). Walks the user chapter-by-chapter in manual order, no skipping. Each node gets a 7-segment deep-dive (what / why exists / how-recipes / why-not-alternatives / can-be-replaced / recursive parameter breakdown / engine logic) plus a PCG practitioner take. Knowledge base accumulates across sessions in ~/.claude/projects/C--Users-nieyi/houdini_manual/. Triggers - 继续学手册 / 学下一节 Houdini / 深拆 X 节点 / 继续 deepdive / study Houdini manual / asked to deeply learn / explain / unpack any official Houdini chapter or node.

- Skill: `hillarybeasley8876-dot/houdini-manual-deepdive-2` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add hillarybeasley8876-dot/houdini-manual-deepdive-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hillarybeasley8876-dot/houdini-manual-deepdive-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: hillarybeasley8876-dot (https://skillmd.com/u/hillarybeasley8876-dot)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/hillarybeasley8876-dot/houdini-manual-deepdive-2

---


# Houdini Manual Deepdive

## Purpose

按 SideFX 官方手册的顺序，逐章逐节深度拆解。**每个节点都要覆盖、不准跳**。

核心信条：
- **百科是终点** — 长跑下来知识库覆盖整本手册
- **架构师走读是方法** — 不写参数表流水账，每段都回答 "为什么这样设计"
- **多会话累积是节奏** — 单次 1-3 个子主题，受 [[feedback_houdini_corpus_pace]] 约束

## What this skill IS NOT

- 不是 [[houdini-architect-analysis]] — 那是从既有 .hip 项目里反推算法
- 不是 [[houdini-pcg-practitioner]] — 那是端到端建造 PCG 资产的 playbook
- 不是 [[houdini-mcp]] — 那是 MCP 集成的设置/排障
- 不是百科快查 — 走读式，不是参数表罗列

## What this skill IS

按手册顺序的"导师"，每次会话陪用户走读 1-3 个子主题，写入知识库。每节最后必给一段 **PCG Practitioner Take** —— 在做 X / Y 类资产时这个节点的角色（受 [[houdini_pcg_practitioner_goal]] 约束）。

## Quick start (per session)

1. 读 [PROGRESS.md](../../projects/C--Users-nieyi/houdini_manual/PROGRESS.md) 找下一个 🟡 起点
2. WebFetch 官方页面（URL 在 PROGRESS / TOC 里）
3. 按 [templates/NODE.md](templates/NODE.md) 或 [templates/CHAPTER.md](templates/CHAPTER.md) 写到知识库
4. 推进 1-3 个子主题后停 + 更新 PROGRESS + 在 chat 报告下次起点

## Reference index

- [METHODOLOGY.md](METHODOLOGY.md) — 一次会话的标准流程 + auto-continue 规则 + 数据真实性约束
- [MANUAL_TOC.md](MANUAL_TOC.md) — Houdini 21 官方手册全目录（路由地图）
- [templates/NODE.md](templates/NODE.md) — 节点深拆 7 段模板
- [templates/CHAPTER.md](templates/CHAPTER.md) — 章节总览模板
- [templates/REFLECTION.md](templates/REFLECTION.md) — 章节通读后的 5-问反思模板（受 [[feedback_houdini_reflection]] 约束）

## Knowledge base location

`~/.claude/projects/C--Users-nieyi/houdini_manual/`
- `PROGRESS.md` — 进度
- `01_getting_started/ ... 09_reference/` — 按手册顶层 9 大块（11 个分组合并到 9 个目录）
- 每个子区一个目录，含 `INDEX.md`（章节总览）、各节点 .md、`99_reflection.md`

## Anti-patterns (hard constraints)

- ❌ 一次写完一章 27 个子页 → 违反 [[feedback_houdini_corpus_pace]]
- ❌ 写参数表却不写"为什么这样设计" → 违反 [[feedback_houdini_learning_style]]
- ❌ 跳过自认为简单的章节 → 用户原话"不准偷懒"
- ❌ 末尾问"要不要继续？" → 违反 [[feedback_houdini_learning_style]] 的 auto-continue
- ❌ 凭训练数据胡编参数名 / 默认值 → 必须先 WebFetch 真实页面
- ❌ 写完不更新 PROGRESS → 下次会话找不到起点

## Output discipline

- 内容主体写到知识库 .md 文件；chat 输出关键发现 + 下次起点
- 章节完读（所有子页）后立刻写 `99_reflection.md`
- 每次会话结束更新 PROGRESS.md 的 "Next session 起点" 段