RTFD 先读我
读文档是前提。这一篇说明为什么，以及这套文档该怎么读。
RTFD —— Read The F**ing Docs*。先读文档，再动手。
这是编程圈最老的一条规矩。代码可以生成，环境不能凭空生成；文档没读，问题迟早找上门。
不看文档就直接上手：出错概不负责。
这套东西是干嘛的
用一个比喻就够：
| 角色 | 是谁 |
|---|---|
| 老板 | 你 |
| 施工队 | AI |
| 水电验收 | DSHA |
你是老板，AI 是施工队。你让它干活，它不该一进门就抡锤子——先进场看水电。
DSHA 就是把下面这套流程，写成 AI 必须遵守的规矩：
- 进场看水电：装没装 Python？有没有 Node？版本对不对？这一步叫 EnvFeel（环境感知）。
- 没有就停工：不硬上、不假装能跑，直接告诉你缺什么、去哪装。任务标
NOT_RUN，不留半成品。 - 有就开工，但留账：每一步留下回执，能倒查是哪步出的错，附复现命令和回滚方法。
它管不了 AI 聪不聪明，但能管住它不许装懂。
这份文档怎么读
三条最容易踩的坑
坑一：以为 AI 能改你的权限挡位。 改不了。挡位由宿主进程持有，AI 只负责如实报告。谁跟你说"我已切换到 full-access"，那是在编。
坑二：看到
NOT_RUN以为是报错。 不是报错，是拒绝执行——这是设计出来的行为，不是故障。任务没开始，也就没有半成品污染。
坑三：不看就上手。 见本文开头。