Comma8/ai-specs
GitHub: Comma8/ai-specs
一套用于约束大语言模型推理方式、交互风格和自主行动规范的行为契约,分为对话和 Agent 两种场景。
Stars: 0 | Forks: 0
## 这个仓库是什么
本仓库定义了我期望与 AI 系统交互的方式:一套**行为契约、思维标准和交互规则**,用于约束模型应如何进行推理、批判以及与我协作。它是模型默认行为与我理想工作方式之间的一层对齐机制。
## 两种灵魂 (Souls)
对话与自主行动是截然不同的任务,其失败模式也各不相同,因此它们适用不同的契约。你可以使用其中一个或同时使用。
| 文件 | 约束内容 | 适用场景 |
|---|---|---|
| `chat/soul.md` | 推理、诚实度、批判性、语气 | 聊天客户端、自定义指令、任何对话场景 |
| `agent/soul.md` | 行动:读写文件、运行命令、修改系统 | 编码 Agent、CLI Agent、任何带有工具的场景 |
### `chat/soul.md`
这是核心准则。适用于每一次交互的不可妥协原则:
* 诚实胜于礼貌
* 明确观点胜于含糊其辞
* 批判性思维胜于盲目安慰
* 保持推进力胜于分析瘫痪
* 人类自然表达胜于机器腔调
如果某项规则放之四海而皆准,它就应该放在这里。
### `agent/soul.md`
这是适用于采取实际行动的 Agent 的操作契约。它默认包含 `chat/soul.md`,并在此基础上添加了自主行动所必需的规则:
* 经验证的声明胜于自信的回忆
* 全局视角,或者明确说明忽略了哪些部分
* 架构优先胜于权宜之计
* 在执行任何不可逆操作前必须确认
* 密钥绝不写入可被读取的位置
* 如实汇报所发生的一切
一个给出错误回答的聊天模型只会浪费一分钟。而一个犯错的 Agent 可能会直接删除数据。
## 如何使用本仓库
### 对话
在开始新对话时,或者在客户端的自定义指令中只需设置一次:
1. 粘贴 `chat/soul.md` 的内容
2. 说一些类似以下的话:
这确立了尽可能高的指令优先级。
### Agent
将这两个文件粘贴到 Agent 的持久化指令文件中(`CLAUDE.md`、`AGENTS.md`、系统提示词或等效位置),请将 `chat/soul.md` 放在前面。
`agent/soul.md` 被刻意设计为通用的。它包含的是可迁移的原则,而非项目规则。任何针对特定代码库的具体内容(其依赖库、构建门禁、部署链)都应放在该项目自己的指令文件中,而不是这里。将项目规则重复复制到本仓库会造成第二事实来源,而这正是这些文档旨在防止的偏差。
### 持续对话
如果行为出现偏差,一个提醒就足够了:
## 本仓库不是什么
* 不是一个人设提示词
* 不是安全框架
* 不是提示词市场
* 不是面向终端用户的文档
* 不是项目配置
本仓库的存在是为了提升**思维质量**,而非仅仅为了让语气顺从。
## 设计原则
* 信号重于噪音
* 深度重于速度(除非速度具有实质性的影响)
* 提供备选方案而非虚假的二分法
* 在能改善推理时提供历史背景
* 明确表达不确定性胜于盲目猜测
## 致谢
两个核心准则中针对劣质内容的禁令提炼自 Hardik Pandya 的 [stop-slop](https://github.com/hardikpandya/stop-slop) (MIT)。
## 核心问题
否则,那就是噪音。
标签:AI交互规范, AI智能体, AI系统提示词, 个人配置, 大语言模型对齐, 防御加固