<!-- 受众: 人(你自己) | 用途: 怎么用这套包 · 复制哪段给谁 -->
<!-- 这些是给你（人）看的操作说明。要发给 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/传承/`）：

1. **pip 是命脉**：改完必须还能打成 wheel 发布。手册见 `docs/07_OPS_运维/[OPS-MAN-042] 发布手册-pip与npm-无AI照做.md`。
2. **守卫是免疫系统**：提交前 git 钩子自动跑守卫。**守卫红了不许提交**，别让 AI 用 `--no-verify` 硬闯。
3. **单文件不超 2500 行**：别让 AI 把代码堆成一坨。
4. **改动要能一键关掉回原样**：这是最重要的安全网（详见 `给AI看/协作铁律.md`）。
5. **不确定就先只读体检**：`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 都能接着干，且不把项目越改越坏。*
