Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

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 review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add newbanser/pristine-skill

About this 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