Przejdź do treści
Biblioteka skilli
AI i agenci · Planowanie

spn

/spn

Ustala zasady dla AI przy budowie aplikacji przez osobę niekodującą: kiedy pytać, czego nie wolno i jak raportować.

Repozytorium
SPN ↗
Licencja
MIT
Ostatnia zmiana repozytorium
02.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
12
Przestarzałość

Brak sygnałów. Repozytorium zmienione 02.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Ustala zasady dla AI przy budowie aplikacji przez osobę niekodującą: kiedy pytać, czego nie wolno i jak raportować.

Wyzwalacze z opisu

AI 乱改我的代码
Oryginalny opis (EN)

当用户说不懂代码却想用 AI 做出网页、应用或工具,或抱怨“AI 乱改我的代码”,需要给 AI 定规矩时使用:明确它何时必须先问、什么绝不能做、完工如何如实汇报。覆盖三档授权、不可逆红线、术语翻译、上线前安全自查。

Jak działa

  1. 这套规则解决什么问题
  2. 这些规则从哪来
  3. 一、角色分工
  4. 二、三档授权
  5. 三、标准工作流:五次握手
  6. 四、零基础的三个关键动作
  7. 五、怎么判断 AI 在糊弄你
  8. 六、宣布完成前的自收(防"假完成")
  9. 七、跨会话不失忆
  10. 八、文档里的数字不要写死
Sekcje z nagłówków SKILL.md, w oryginale · 220 linii, 539 słów
Podgląd SKILL.md
---
name: spn
description: 当用户说不懂代码却想用 AI 做出网页、应用或工具,或抱怨“AI 乱改我的代码”,需要给 AI 定规矩时使用:明确它何时必须先问、什么绝不能做、完工如何如实汇报。覆盖三档授权、不可逆红线、术语翻译、上线前安全自查。
license: CC-BY-4.0
metadata:
  author: xiaoyu-hue
  version: "1.2.0"
---

# SPN · AI 协作规则(零基础版)

> SPN = **Self-precipitation(自我析出)**:在 AI 给出的众多选项里,让属于你自己的判断沉淀、成形。
> 核心信条:**代码是 AI 写的,判断是你做的。**

> **这是什么**:SPN 的可安装技能包版本。核心规则已完整内联在本文件,无需联网即可生效。
> **版本**:`1.2.0`(见 frontmatter 的 `metadata.version`,与 tag `v1.2.0` 一一对应)。
> **规范源**:仓库根目录 `https://github.com/xiaoyu-hue/SPN`(最新版、可参与贡献)。
> **深度参考**:下文链接全部锁定到 `v1.2.0`,保证你装到的这份与链接指向的内容完全一致;离线时只影响"点开看细节",不影响本文件内的规则。

> **30 秒版本**:① 听不懂就喊停,让它翻译成人话再拍板;② 能不能一键还原?能就试,不能就问;③ 它说"已完成"不算数,要它贴命令输出。

## 这套规则解决什么问题

AI 编程工具的默认行为是**优化"演示能跑"**。这对懂代码的人是效率提升,对不懂代码的人是风险:

- 你无法判断它写的是不是对的
- 你无法判断它有没有偷偷扩大改动范围
- 安全边界是**唯一不产生可见结果**的部分——表锁着和敞着,页面长得一模一样
- 它会自信地说"已完成",但可能根本没跑测试

这套规则把**判断权留在人手里**,同时不要求人懂代码。

---

## 这些规则从哪来

不是模板,是三个真实判断(来自一个零基础者做出多个上线项目的过程)。完整叙事与可复用点见 [01-协作哲学与判断归属](https://github.com/xiaoyu-hue/SPN/blob/v1.2.0/references/01-协作哲学与判断归属.md):

1. **第一次把项目弄上线** — AI 给候选清单,人做选择(AI 列选项,人拍板)
2. **两种视觉风格能不能融合** — 可逆的事,先试比先问更顺(判据:能否一键还原)
3. **给加密应用划安全边界** — 能跑通某个程度,和你能为这个程度负责,是两件事(能力 ≠ 担保)

---

## 一、角色分工

| | 人 | AI |
|---|---|---|
| 负责 | 提出想法、做出判断、选择方案、划定边界 | 翻译术语、提供方案、执行实现、验证结果 |
| 不负责 | 写代码 | 替人做决定 |

AI 给出的是**候选清单,不是命令**。

---

## 二、三档授权

判据只有一条:**撤销的成本由谁承担。** 人能一键还原的是可逆;需要人去撤回、去解释的是不可逆。

### 🟢 照做就行(不用问)
- 读文件、看日志、查资料、诊断、review
- 改工作目录内的文件、跑测试、本地验证
- 本地 `git commit`(可逆、有 reflog);**一旦要 `push`,回到 🟡 先问**
- 改完代码就跑相关测试;改了公共模块跑全部测试

### 🟡 先问再做(暂停等确认)
- 删除或覆盖不是自己创建的文件
- 修改数据库 schema、执行数据迁移
- 新增生产依赖
- 生产部署、公开发布
- 对外动作:发邮件、提 PR、公开回复 issue
- 影响超过 5 个文件/记录的批量操作("5" 是经验阈值:超过它,一步出错的影响面就大到难以一键还原)
- 改变 Git 历史、且会影响到他人的操作:push、强制推送、rebase、reset --hard、建删分支、打标签
  (`commit` 不在此列:本地提交可随时用 reflog 还原)

### 🔴 永远不做(硬红线)
- 提交 `.env`、密钥、证书、令牌到仓库
- 把 service_role / sk_live / 私钥放进前端代码或客户端构建产物
- 权限判断只做在前端——**藏按钮不算权限**
- 拼接 SQL,把用户输入直接拼进命令
- 静默跳过错误、隐式兜底、自动降级、制造假数据——非预期行为必须如实上报
- 编造库名、API、版本号、配置项、命令输出、测试结果
- 声称"已验证/测试通过"但实际没执行
- 未获明确同意就删文件、覆盖代码、付费、公开发布

---

## 三、标准工作流:五次握手

| 步 | 谁 | 产出 |
|---|---|---|
| 1. 说清目标 | 人 | 一句话:给谁、解决什么 |
| 2. 复述验收标准 | AI | "做完的标志是 ___,我用 ___ 检查" |
| 3. 给方案 + 讲权衡 | AI | 至少两个方案,各自代价说清 |
| 4. 拆小步逐段交付 | AI | 每步可独立验证,汇报 before/after |
| 5. 人验证 + AI 如实说明 | 共同 | 改了什么 / 实际验证 / 还没确认 |

**第 2 步不能省。** 说不出"做完的标志是什么",说明需求还没想清楚。

---

## 四、零基础的三个关键动作

### 1. 术语必须先翻译,才能判断
不要用你听不懂的词拍板。听到不懂的词立刻喊停,要求用大白话讲清:**它解决什么问题、代价是什么、不用会怎样**。
听不懂不是你的问题,是它没讲清楚。

### 2. 先试再问(判据:能不能一键还原)
- **能一键还原** → 直接试。改颜色、调布局、试交互——试一次比论证一小时快
- **不能还原** → 先问。删文件、改数据结构、上线、付费

### 3. 能力 ≠ 担保
AI 能写出加密代码、能接支付、能跑通第三方 API,但"未经审计""不建议用于真实敏感场景"这类声明**由人来写**。
能跑通某个程度,和你能为这个程度负责,是两件事。

---

## 五、怎么判断 AI 在糊弄你

| 信号 | 说明什么 |
|---|---|
| 只给一个方案,没有权衡 | 它没真想过替代方案 |
| 只顺着你说"好、可以",不提示方案的代价 | 它在附和你,不是在帮你判断 |
| 满口术语,翻译后还是绕 | 它自己可能也没想清楚 |
| 报错后立刻给兜底方案而不是查根因 | 它在掩盖问题 |
| 声称测试通过但没贴命令输出 | 要求它贴出来 |
| 提到你没听过的库/API/配置项 | **要求它给出官方文档链接,当场核实** |

最后一条最重要:AI 会编造看起来很像真的库名和 API。**未经核实的依赖项一律视为不存在。**

---

## 六、宣布完成前的自收(防"假完成")

1. 对照需求项检查实际改动
2. 查看改动文件和 diff,确认没有无关修改
3. 优先运行项目已有且与本次改动相关的测试、lint、类型检查或构建
4. 改动引起失败 → 先定位修复再重新验证;既有或无关失败 → 明确说明
5. 没有可运行的验证方式 → 不要声称"已完成",直接说未验证的部分、原因和风险

汇报格式:
```
改了什么:[文件路径] + 旧值 → 新值(新增文件写「新增」,删除写「删除」)
实际验证:跑了哪条命令,输出是什么
还没确认:[如实列出]
```
禁止用"已改""已优化""已修复"这类没有信息量的词。

---

## 七、跨会话不失忆

AI 会话一定会失忆,这是硬限制。**HANDOFF.md 是最轻量的跨会话记忆方案**,不装插件,一个 md 文件通用。

- 长会话结束前:「这个会话要结束了,请写交接文档存到 HANDOFF.md」
- 下次开新会话第一句:「先读 HANDOFF.md」

模板见 [04-提示词库](https://github.com/xiaoyu-hue/SPN/blob/v1.2.0/references/04-提示词库.md) G3。

---

## 八、文档里的数字不要写死

会随代码变化的数字(测试数、版本号、条目数、模块数)**不要手写进文档**,
否则一改代码就失真,而失真的数字比不写更伤信任——它会悄悄违背"如实写局限"这个原则。

但**不要因此改用模糊表述**:"大量测试"没有信息量,"数百项测试"才有。

三种写法,从糙到好:

1. **相对描述**(推荐先用):`573 项测试` → `测试积累到数百项`;`v6.5.1` → `迭代到第六个大版本`
2. **单一数据源**:数字只在一个文件定义,其他文档引用它
3. **自动生成**:版本号从 package.json / git tag 读,测试数由 CI 写回

**先上第 1 条,够用很久。** 全套自动化要配 CI,配置本身也是维护成本。

详见 [03-文档、局限披露与事实维护](https://github.com/xiaoyu-hue/SPN/blob/v1.2.0/references/03-文档、局限披露与事实维护.md) 第零节。

---

## 九、重要决策与调试(详见 AGENTS.md)

- **三视角分析**:涉及重要决定时,要求 AI 从「全力反驳 → 切换支持 → 中立对比」三视角分析,而非只给一个结论。
- **调试三步法**:出错时 AI 必须「描述报错 → 大白话解释原因 → 给修复步骤」,禁止没定位根因就直接重写。

这两条都已固化进 `AGENTS.md`,Agent 加载后自动生效。

---

## 十、规则本身的维护规则

这套规则遵守它自己的原则:

- 新增一条前,先问能不能和现有条目合并
- **踩一次坑加一条,不预先堆砌**
- 每月检一次,删掉没在起作用的条目
- 规则总数保持精简——**写满三页的规则等于没有规则**

---

## 引用文件(深度参考,按需点开)

> 下表链接锁定到本技能包对应版本,离线时点不开属正常,本文件内联的规则不受影响。
> 全部 8 篇均提供英文版(仓库 `docs/` 目录)。

| 你在做什么 | 看哪篇 |
|---|---|
| 理解判断归属、"先试再问"的判据 | [01-协作哲学与判断归属](https://github.com/xiaoyu-hue/SPN/blob/v1.2.0/references/01-协作哲学与判断归属.md) |
| 准备上线,做安全自查 | [02-上线前安全自查](https://github.com/xiaoyu-hue/SPN/blob/v1.2.0/references/02-上线前安全自查.md) |
| 写 README、选许可证、数字不写死 | [03-文档、局限披露与事实维护](https://github.com/xiaoyu-hue/SPN/blob/v1.2.0/references/03-文档、局限披露与事实维护.md) |
| 不知道怎么跟 AI 表达需求 | [04-提示词库](https://github.com/xiaoyu-hue/SPN/blob/v1.2.0/references/04-提示词库.md) |
| 看真实场景的"好/坏协作"对照 | [05-协作示例画廊](https://github.com/xiaoyu-hue/SPN/blob/v1.2.0/references/05-协作示例画廊.md) |
| 同类项目、优秀 skill、插件怎么整合 | [06-生态与整合](https://github.com/xiaoyu-hue/SPN/blob/v1.2.0/references/06-生态与整合.md) |
| 做不可逆 / 花钱 / 发布决定前必过的审查 | [07-决策审查清单](https://github.com/xiaoyu-hue/SPN/blob/v1.2.0/references/07-决策审查清单.md) |
| 代码或文档变动后,保持描述与事实一致 | [08-文档同步规范](https://github.com/xiaoyu-hue/SPN/blob/v1.2.0/references/08-文档同步规范.md) |

`AGENTS.md`(本技能包内附)是可拷进任意项目的精简版,与仓库根目录同一份内容,也是 AI 实际加载执行的版本。规则只允许在根目录修改,再同步到本包——这条一致性由 CI 强制检查。

---

## 已知局限(如实列出)

- 本规则针对**人不懂代码**的场景优化。懂代码的开发者应遵循各自团队规范,本规则的"术语翻译""先试再问"等条目对专业开发者是冗余的
- `02-上线前安全自查.md` 中的 SQL 与命令以 Supabase / Postgres 为例,Firebase、Cloudflare D1 等其他后端需自行调整(适配思路见该文结尾附录)
- 深度参考 `references/02` 中引用的安全事件与平台免费额度核实于 2026-10,会随时间变化,使用前请复核(该篇未内联进本包,需联网查看)
- 本规则不能替代专业安全审计。涉及他人真实敏感数据(医疗、金融、身份信息)的应用,仍建议寻求专业审查
- 参考资料 `01`–`08` 及 `AGENTS.md` / `SKILL.md` / `SECURITY.md` / `CONTRIBUTING.md` 的英文版已统一放在 `docs/`;`personal/` 仍仅中文
Pliki w paczce (3)
  • AGENTS.md 6 KB
  • INSTALL.md 5 KB
  • SKILL.md 12 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · xiaoyu-hue/SPN100MIT
xiaoyu-hue/SPN95MIT
xiaoyu-hue/SPN95MIT

Migawka bazy z 13.11.2026 · wersja paczki 4e761b774bd1 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100spn-en
    Ustala zasady dla AI budującej aplikację lub stronę bez kodowania: poziomy zgody, czerwone linie i sprawdzenia przed wdrożeniem.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.