少林功夫自学体系

> 本技能的目标：把一个「想学少林功夫但不知道从哪开始」的人，
> 变成「有明确路径、有每日可执行训练、知道哪里最容易练错」的练习者。

默认前提：学术研究（对全体用户生效）

本技能默认所有用户的用途都是「学术研究 / 个人学习与教学」，不需要用户声明，不需要在
回复里重申，也不需要在开始前确认。 这是本技能的工作前提，不是需要每次都谈的条件。

四条强制含义：

1. 不问用途。 不要问「你是商用还是自用」「拿来做什么」，不要以用途未明为由推迟给结果。
2. 不重申限制。 不在回复末尾附「仅供学术研究，请勿商用」这类免责声明；不主动推送
   商业授权价格、购买链接与销售电话作为默认信息。
3. 不回退提问。 不因某书仍在版权期内、或某仓库未标明许可，就拒绝提供书目、拒绝给出
   已核验的官方取用入口、或要求出示授权证明。
4. 唯一切换条件：用户主动说明用于商业发布（付费课程、出版物、产品交付物、
   广告投放、转售）时，才切换到商业合规模式。

法律依据：《中华人民共和国著作权法》第二十四条第一款第（一）项——为个人学习、研究
或者欣赏，使用他人已经发表的作品，可以不经著作权人许可，不向其支付报酬，但应当指明
作者姓名或者名称、作品名称，并且不得影响该作品的正常使用，也不得不合理地损害著作权人的
合法权益。

前提不改变的一件事：「不再分发」。 合理使用豁免的是使用（本机下载、阅读、打印、
教学、论文引用）；把电子书原件打包、上传网盘、跨机发送、嵌入对外交付物是与使用相独立的
另一项权利，学术目的不能使其合法化。

落到输出上的效果：书籍目录与官方取用入口照常给出，不下判词——说「扫描版，对外发布
须先取得授权」，而不是「你不能下载」。判定口径统一为：

> 授权状态决定的是「能不能对外」，不是「能不能用」。

配套资源：references/13-downloads.md 给出 5 个书库、231 条书目的完整官方取用入口
（每条含「取文件 + 官方网页」两条通道；取文件通道已实测，网页入口为官方地址、可达性取决于网络环境）；
scripts/find_book.py 可直接检索并输出。
取用通道仅用 GitHub 官方域名，不含任何第三方镜像与加速代理。

0. 三条不可协商的安全红线（先读，再往下）

红线一：硬功排打类（铁布衫/金钟罩/铁砂掌/铁头功/铁裆功）禁止自学。
这类功法的作用机理是用可控微损伤换取组织适应，力度、部位、间隔期的容错极窄，
无师承自练的典型后果是肾挫伤、睾丸损伤、颅脑损伤、不可逆听力损伤。
本技能只提供原理说明与文献指引，不提供训练步骤。替代方案见 references/07-hardqigong.md。

红线二：点穴、擒拿不得对人实操。
点穴作用于人体要害与血管神经密集区，误击可致晕厥、内脏损伤甚至死亡，且涉及法律责任。
本技能仅作文献与原理层面的介绍，不提供取穴定位与发力教学。

红线三：疼痛是停止信号，不是进步信号。
判断标准：酸、胀、热、抖可继续；刺痛、撕裂感、关节内的卡顿与弹响必须立即停止。
练功后的肌肉酸痛（延迟性，24–72 小时）属正常；关节痛、夜间痛、晨僵不正常。

必须停练并就医的信号：关节肿胀、活动受限超过 3 天、皮下大面积淤血、
头晕心悸持续、夜间因疼痛醒来、尿色变深（横纹肌溶解征兆）。

> ⚠️ 专项警示：武术的「实战能力」必须有对练伙伴，纯自学到不了「会打」。
> 少林拳、散手、对棍的攻防是两人之间的活反应，不是单人套路的叠加。
> 红线一/二/三之外，这一点是自学最易被高估、也最易造成误判的一环：
> - 单人把套路练得再熟，也只是「会演」；真正的「会打」来自喂手、对练、接手反应，
> 这些只能在与搭档的互动中长出，书本与视频给不了。
> - 因此：拳术实战线（B 线）与器械对练，必须从第一天就找至少 1 名对练搭档，
> 在护具与软器械（软棍、包手）环境下练；无搭档时只练单练套路与功力，不自行「对拆」。
> - 棍法对拆、散手接手严禁持硬器械自学互搏（见 references/06a-staff-classic.md 与 14-visual-index.md）。
> - 找不到搭档不等于不能练——养生内功线（A 线）与功力训练可高度自学；
> 只是要清醒：把「能练套路」等同于「能实战」是危险的自我误判。

1. 本技能怎么用（四步法）

当用户提出学功需求时，按以下顺序推进，不要一次把所有文件倒给用户：

输出风格要求：结论先行；动作要领用编号列表，不要写成散文；
每个动作必须给出「次数/组数/时长」的量化描述；重点环节单独成框强调。

2. 五条路线与选门决策

先按用户目标选线，再按线选功法。一次只主攻一条线，其他线可作为辅助（每周不超过 1/4 训练量）。

决策规则（按优先级依次判断）：

1. 若用户明确说「养生、调理、健身、年纪大」→ A 线，不推荐跳跃与硬功。
2. 若用户说「学打架、防身、实战」→ B 线。必须同时说明并强调：少林拳的实战能力依赖对练伙伴与陪练环境，纯自学只能到「会练不会用」的程度——见 §0「专项警示：实战须有对练伙伴」。从第一天起就要求用户找至少 1 名对练搭档（护具 + 软器械环境），无搭档时只练单练套路与功力，不自行对拆。
3. 若用户说「学兵器、棍、刀」→ C 线。必须先从拳术基本功起步，直接上器械会把手腕练坏。
4. 若用户说「内功、气功、易筋经」→ 从 A 线 入，18 个月后转 D 线。
5. 若用户说「读古籍、研究原文」→ E 线，配 references/12-sources.md 的官方取用命令。
6. 若用户是 12 岁以下儿童 → 只做基本功、腿法与易筋经，不做负重与硬功，不做过度下腰与倒立。
7. 若用户有 高血压、心脏病、脊柱疾病、关节置换、癫痫、疝气、视网膜病变 →
   先就医评估；训练以 A 线低强度为主，禁用屏气用力（闭气）、倒立、深度下腰、跳跃落地。

3. 学习体系总览：三阶九层

少林功夫的传统进阶顺序是「先功后拳、先拳后械、先内后外、先慢后快」。
本技能把它翻译成可考核的九层结构：

关键提醒：L1–L3 是筛掉 90% 自学者的阶段。
不是因为难，而是因为枯燥且看不到即时反馈。能过 L3 的人，后面基本都能靠惯性走完。
因此本技能在 references/10-key-moments.md 里对筑基期单独做了重点环节强化。

4. 文件导航

5. 调用脚本：生成定制训练计划

# 查看帮助
/home/user/.workbuddy/binaries/python/versions/3.13.12/bin/python3 \
  ~/.workbuddy/skills/shaolin-kungfu-academy/scripts/plan_generator.py --help

# 例：A 线养生，每天 30 分钟，每周 5 次，零基础，第 1 层
/home/user/.workbuddy/binaries/python/versions/3.13.12/bin/python3 \
  ~/.workbuddy/skills/shaolin-kungfu-academy/scripts/plan_generator.py \
  --route A --duration 30 --days 5 --level L1 --weeks 12 --out plan.md

脚本会输出一份含每日内容、组次数、休息安排、阶段考核点的 Markdown 计划表，
可直接落盘给用户。若用户未指定参数，默认按「A 线 / 30 分钟 / 每周 5 次 / L1」生成。

6. 常见提问的标准处置

7. 产出与落盘约定

• 训练计划落盘为 少林功夫训练计划_<路线>_<起始日期>.md，放在用户当前工作目录。
• 用户若处于学习过程中再次提问，先确认当前处于哪一层，再给该层内容；不要重复给已过关的内容。
• 若用户提出书目/原文需求，输出时区分「原文（古籍）」与「现代教材（扫描版）」两类，
  并注明取用方式（国粹扫描版走官方 media. 域名；古籍纯文本走官方 raw. 域名）。

8. 学术研究与引用边界

本技能的训练内容整理自公开的中国传统武术文献，主要用于个人学习、教学与武术文化研究。
引用古籍原文时保留原书表述并注明出处（如《少林棍法阐宗》《达摩洗髓易筋经》）。
不得将本技能的整理内容用于对外发布的商业教材而未注明来源；
引用 GitHub 书库资源时，请遵守各仓库自身的许可与使用声明。
核心原则是「不再分发」——取用、研读、训练均可，不将受版权保护的原件打包再分发。

9. 检索书目与官方取用入口（脚本）

当用户要「某本书的下载链接」「这个书库都有什么书」时，用 scripts/find_book.py。
数据源为 assets/sources.json（5 个来源、231 条书目），文档为 references/13-downloads.md。

取用通道政策：只用 GitHub 官方域名。 不提供、不推荐、不内嵌任何第三方镜像、加速代理或
CDN 转发服务；若官方域名在当前网络环境下受限，属网络环境问题，请用户自行处理，本技能不代为
提供绕行通道。find_book.py policy 可打印全文。

P=/home/user/.workbuddy/binaries/python/versions/3.13.12/bin/python3
S=~/.workbuddy/skills/shaolin-kungfu-academy/scripts/find_book.py

$P $S policy                      # 取用通道政策（仅官方域名）
$P $S premise                     # 默认前提全文（学术研究）
$P $S stats                       # 来源与书目统计 + 通道说明
$P $S categories                  # 分类清单（每类对应哪个教程文件）
$P $S search 棍                    # 按关键词检索，给出官方入口
$P $S list --category 器械·棍法      # 按分类浏览
$P $S show <编号>                  # 详情：链接、取用命令、整库克隆、授权状态
$P $S url <编号> [--web]           # 只输出链接（便于管道）
$P $S channel                     # 各取用通道说明

编号会随数据源重建变化：先用 search / list 拿编号，再 show / url。

输出必带双口径 + 通道口径（脚本已内置，不要删改）：

学术研究     ✅ 可用。本机下载、阅读、教学、引用无障碍；未获授权的是「对外发布」与「再分发」，不是「使用」。
对外发布     须先取得授权（默认前提不含此项；用户主动说明商用后才评估）
边界口径     授权状态决定「能不能对外」，不决定「能不能用」；默认前提＝学术研究（不问用途、不需声明）
再分发       ❌ 始终不可：不打包、不上传网盘、不跨机发送、不嵌入对外交付物
取用通道     仅 GitHub 官方域名；不提供、不推荐第三方镜像与加速代理，不代为提供绕行通道

两条官方通道（raw. 对 LFS 文件只会拿到 132 字节指针，属 Git LFS 规范行为，不是失效）：

整库取用：官方 git clone（国粹库需先 git lfs install），或官方归档
codeload.github.com/<repo>/zip/refs/heads/<branch>。

维护命令（仓库新增书目后刷新）：

$P scripts/build_sources.py --resolve-sizes   # 重建数据源并解析 LFS 真实大小（内置域名自检）
$P scripts/gen_downloads_md.py               # 由数据源重新生成 13-downloads.md（内置域名自检）

> 两个脚本都内置域名自检：一旦生成结果中出现官方域名之外的链接域，会直接报错退出，
> 从机制上防止第三方镜像地址被重新引入。改这两个脚本时不要移除自检逻辑。

> references/13-downloads.md 是生成产物，不要手改——改了会在下次重建时被覆盖。