开发与测试
Pristine Skill
A first-principles agent skill that enforces clean coding practices, no patching, and single source of truth for AI coding agents.
newbanser · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add newbanser/pristine-skill技能说明
Pristine
English | 简体中文
如果失忆是根因,那就让AI的每次重生都遵从纯净原则。
这或许是你唯一需要使用的agent skill,让你的产出永远像第一次写出来一样。 纯净、清晰、节约。
支持 Claude Code、OpenAI Codex、OpenCode、OpenClaw(开放 Agent Skill 格式)。
当前版本:v1.6.0
你需要知道
在 AI 辅助开发中,补丁的累积方式和纯人类团队不一样:
- 代码常被重写,但 文档和记忆是跨会话唯一的桥 —— 一条过期的记录会让下一个 Agent 基于错误前提做决定。
- Agent 读的是整个文件,不是 diff —— 每一个遗留的特殊分支都在稀释真实设计的信号。
- 一个"能用"的补丁是最容易被复制的,因为它最不需要理解。每一轮打补丁,都在教下一个会话打补丁。
Pristine 是反向的力:每一次改动都像第一次写出来,让系统朝清晰演进,而不是朝熵演进。
你的AI需要知道
| 定律 | 含义 |
|---|---|
| 追溯根源(No patching) | 修根因,不修症状。没有 if 特殊分支、没有复制改参数的逻辑、没有绕开问题的开关。补丁堆比干净重写更糟时,就重写。 |
| 代码自释(Code explains itself) | 名字承载"是什么"。注释只说"为什么":业务规则、约束、刻意的取舍。没有解释性注释、没有注释掉的代码块。 |
| 不留残渣(No residue) | 没有备份、草稿、死代码、中间状态。被取代的规则就地更新,绝不追加"截至……"的说明。 |
| 部署如一(Deployment parity) | 线上跑的就是本地审过的。没有只在线上做的快速修复 —— 仓库必须始终代表现实。 |
| 单一真源(Nothing extra) | 每个行为只有一个来源:先复用已有的,不需要存在的就不写。非平凡逻辑留一个可运行的机械验证 —— 自检是人类的习惯,不是 AI 的机制。 |
| 会话成本(Session cost) | 无限增长的会话和无限增长的文件是同一种熵。约 15 轮时,主动提议重置。 |
| 上线初稿(First draft before launch) | 上线前没有存量用户:改定义,不改兼容。没有迁移、没有 ALTER TABLE、没有兼容层 —— 只为了承载旧形态的代码,一律删掉。 |
安装
把 SKILL.md 复制到你的 Agent 技能目录:
# Claude Code
mkdir -p .claude/skills/pristine
cp SKILL.md .claude/skills/pristine/
# OpenAI Codex
mkdir -p .agents/skills/pristine
cp SKILL.md .agents/skills/pristine/
# OpenCode
mkdir -p .opencode/skills/pristine
cp SKILL.md .opencode/skills/pristine/
可选:会话监视(见下)需要把 scripts/session-watch.js 和 SKILL.md 放一起 —— 或者 clone 整个仓库、让 hook 指向 clone,这样 hook 路径稳定。
用法
技能在你开始实现、重构、修 bug 时自动激活,也在"先打个补丁再说"的冲动出现时激活。也可以按名字主动调用:
pristine—— 正式名("we work in pristine mode")纯净原则/first-time—— 别名,通过技能描述语义识别
会话监视(可选配套)
scripts/session-watch.js 机械地执行 15 轮规则:数当前会话的真实用户轮次,超过阈值就打印提醒。把它挂成 Claude Code 的 UserPromptSubmit hook(每条用户消息触发;Stop hook 也可以):
"hooks": { "UserPromptSubmit": [ { "hooks": [ { "type": "command",
"command": "node /path/to/scripts/session-wat