<!-- 受众: 人(你自己) | 用途: 怎么用这套包 · 复制哪段给谁 -->
<!-- 这些是给你（人）看的操作说明。要发给 AI 的内容在 ../给AI看/ 。 -->
🧑 使用说明 · 这套包怎么用（给你自己看）#
这一篇是写给你（人）的。它告诉你：这套东西是干嘛的、遇到什么情况打开哪个文件、复制哪一段发给 AI。
你不需要记住任何技术细节，只需要会复制粘贴。
一句话：这套包解决什么#
以后你没有强 AI 陪着开发了，只能用弱模型或陌生的大模型，而且只能靠 pip 发布。
这套包把「怎么跟 AI 讲清项目、怎么让它别把项目改坏、遇到错误怎么修、下一步做什么」
全部写成可以直接复制粘贴给 AI 的现成文字，你照着贴就行。
目录怎么分（最重要）#
这个包分成两半，别搞混：
| 目录 | 给谁看 | 里面是什么 |
|---|---|---|
给AI看/ | AI | 直接复制、整段发给 AI 的内容（开场白、铁律、错误手册、任务卡） |
给人看/ | 你 | 怎么操作、怎么选、怎么排错、发展方向怎么定（就是你现在看的这些） |
规则：
- 要发给 AI 的时候 → 去
给AI看/复制。 - 你自己想知道怎么办 的时候 → 看
给人看/。
标准流程（照这个顺序做）#
第 1 步 · 开一个新 AI 会话，先发「开场白」（必做）#
打开 给AI看/项目情况说明-开场白.md，看对方是什么模型：
| 对方模型 | 复制哪一档 |
|---|---|
| 强模型 / 大上下文（如某家旗舰大模型） | A · 全量开场白 |
| 普通模型 | B · 精简开场白 |
| 本地小模型（≤7B，如 qwen/phi/deepseek-coder） | C · 小模型极简开场白 |
把那一档 ``` 代码块里的整段文字，作为新会话的第一条消息发出去。
第 2 步 · 要它改代码前，发「铁律速查卡」#
打开 给AI看/协作铁律.md，复制顶部「铁律速查卡」那段，发给它。
这是保命的一步——它规定 AI 只能用「一个开关就能关掉恢复原样」的方式改代码。
第 3 步 · 派活 / 排错#
- 想让它干活：打开
给AI看/任务派发卡.md，挑一张卡，连同「派发头」一起发给它。
不知道挑哪张？看 给人看/发展路径-决策与选活.md 的决策树。
- 它出错了：打开
给AI看/错误自查手册.md，找最像的一条发给它；
或直接对它说「对照错误自查手册逐条自审你刚才的改动」。
自己想快速判断是什么错？看 给人看/排错速查-给人.md。
什么情况打开哪个文件（速查）#
| 你的处境 | 打开 |
|---|---|
| 刚开新 AI 会话 | 给AI看/项目情况说明-开场白.md（复制一档发它） |
| 要它动手改代码 | 给AI看/协作铁律.md（复制速查卡发它） |
| 想派个活但没头绪 | 给人看/发展路径-决策与选活.md（决策树）→ 给AI看/任务派发卡.md（挑卡发它） |
| AI 报错 / 我怀疑它改坏了 | 给人看/排错速查-给人.md（判断）→ 给AI看/错误自查手册.md（发它去修） |
| 我自己怕把项目搞坏 / 要发布 | 给人看/命脉自保清单-给人.md |
贴给 AI 前，你自己要守住的 5 件事#
即使 AI 全忘了，这 5 条你要守住（完整版在 .ai/GUARDS.md 和 docs/传承/）：
- pip 是命脉：改完必须还能打成 wheel 发布。手册见
docs/07_OPS_运维/[OPS-MAN-042] 发布手册-pip与npm-无AI照做.md。 - 守卫是免疫系统：提交前 git 钩子自动跑守卫。守卫红了不许提交，别让 AI 用
--no-verify硬闯。 - 单文件不超 2500 行：别让 AI 把代码堆成一坨。
- 改动要能一键关掉回原样：这是最重要的安全网（详见
给AI看/协作铁律.md）。 - 不确定就先只读体检：
node services/backend/bin/khy.js maintain freshness；慌了看docs/传承/紧急恢复卡片.md。
和已有文档的关系#
这套包不替代已有文档，只是加一层「发给 AI 用」的外壳：
- 无 AI 也能维护的人类手册：
docs/传承/KHY-OS-传承书.md - 再造一个 khyos 的蓝图：
docs/传承/KHY-OS-复制蓝图-如何再造一个khyos智能体.md - 机器可读项目地图/红线：
.ai/MAP.md、.ai/GUARDS.md、.ai/GUARDS-AI.md
冲突时以 .ai/ 和 docs/传承/ 为准（它们由守卫/钩子保持最新）。
本包由原作者在「最后一天使用强 AI」时刻意沉淀，目标：换任何 AI 都能接着干，且不把项目越改越坏。