<!-- 受众: 人+AI 通用入口 | 用途: 整个 AI协作预设包 的总入口 -->
🧭 AI 协作预设包 · 总入口#
这套包干什么：在「以后只能用弱模型/陌生大模型、且只能靠 pip 分发」的情况下，
让你能把 Khy-OS 继续开发下去。做法是把「怎么跟 AI 讲清项目 / 让它别改坏 / 出错怎么修 / 下一步做什么」
全部写成现成文字，你复制粘贴给 AI 即可。本包严格区分两类读者——这是使用前必须先搞清的：
📁 两条分线（别搞混）#
| 目录 | 给谁看 | 你什么时候进去 |
|---|---|---|
🤖 给AI看/ | AI（整段复制发给它） | 要发内容给 AI 时 |
🧑 给人看/ | 你自己（操作与决策） | 你想知道怎么办 时 |
一句话：要喂给 AI 的 → 去
给AI看/；你自己拿不准 → 看给人看/。
🚀 先看两份「总说明」（最快掌握）#
| 想快速掌握 | 打开 | 怎么用 |
|---|---|---|
| 你自己 30 秒看懂全局 | 🧑 给人看/总说明-一页速览 | 扫一眼就能上手 |
| 让 AI 一次读懂全局 | 🤖 给AI看/总说明-一次读懂全局 | 整段复制发给 AI，读完即可开工 |
🧑 给人看/（你先从这里开始）#
| 文件 | 什么时候看 |
|---|---|
| 总说明-一页速览 | 最先看 —— 30 秒掌握全局 |
| 使用说明-怎么用这套包 | 想了解完整流程、复制哪段给谁 |
| 排错速查-给人 | AI 出错、怀疑它改坏时 —— 症状对照表 |
| 发展路径-决策与选活 | 想派活但没头绪 —— 决策树 |
| 命脉自保清单-给人 | 怕改坏 / 要发布 / 要回退 |
🤖 给AI看/（复制里面的内容发给 AI）#
| 文件 | 什么时候发给 AI |
|---|---|
| 总说明-一次读懂全局 | 想让 AI 一次掌握全貌（自包含，整段发） |
| 项目情况说明-开场白 | 每次开新会话第一件事（选 A/B/C 一档发） |
| 协作铁律 | 要它改代码前（发"铁律速查卡"） |
| 错误自查手册 | 出错时、或让它自查时 |
| 任务派发卡 | 派活时（挑一张卡 + 派发头发它） |
🧩 skills/（装进 khy，指导弱模型现场执行）#
文档是"讲清与传阅"，skill 是"现场执行"——装进 khy 后，模型在会话内随时 /激活 拿到本项目纪律。
你平时主要用小模型，把这套装上最省心。
| 入口 | 说明 |
|---|---|
| skills 集合总说明 | 怎么安装到 khy（khy skill import 或放 ~/.khy/skills/）+ 8 个 skill 何时用哪个 |
一键装全部：
for d in docs/AI协作预设包/skills/*/; do node services/backend/bin/khy.js skill import "$d"; done⏱️ 三步最短用法#
- 讲清项目：开新 AI 会话，从
给AI看/项目情况说明-开场白.md按对方模型选一档，整段发出去。 - 立规矩：要它改代码前，把
给AI看/协作铁律.md的「铁律速查卡」发给它。 - 派活/排错：派活去
给AI看/任务派发卡.md挑卡发；出错去给AI看/错误自查手册.md找条发。
自己拿不准怎么选/怎么判断 → 看对应的 给人看/ 文件。
5 个你要守住的铁事实（即使 AI 全忘了）#
- pip 是命脉：改完必须还能打成 wheel 发布（
docs/07_OPS_运维/[OPS-MAN-042] 发布手册）。 - 守卫是免疫系统：守卫红了不许提交，别让 AI 用
--no-verify。 - 单文件不超 2500 行。
- 改动要能一键关掉回原样（默认开的 KHY_ 开关 + 逐字节回退）。
- 不确定就先只读体检：
node services/backend/bin/khy.js maintain freshness；慌了看docs/传承/紧急恢复卡片.md。
与既有文档的关系#
本包不替代已有文档，只加一层「发给 AI 用」的外壳。冲突时以 .ai/ 和 docs/传承/ 为准：
- 人类维护手册：
docs/传承/KHY-OS-传承书.md - 机器可读地图/红线：
.ai/MAP.md、.ai/GUARDS.md、.ai/GUARDS-AI.md - 弱模型兼容设计：
docs/03_DESIGN_设计/[DESIGN-ARCH-013] 弱模型兼容.md
本包由原作者在「最后一天使用强 AI」时刻意沉淀，目标：换任何 AI 都能接着干，且不把项目越改越坏。