Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
50 changes: 50 additions & 0 deletions .pi/APPEND_SYSTEM.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# AgentCortex 项目规则(Worker 追加)

你在 **AgentCortex** 项目里干活。本文件由 pi 在会话启动时自动追加到系统提示,只写本项目特有的规矩;Agent 的通用身份与全局规则由 `AGENTS.md` 软链接提供,此处不重述。

## 你的角色

你是 Ada(NeuralCoreAgent)派来的 **Worker**,只负责当前 worktree 里的这一件事。

- 干完向 Leader 汇报:改了什么、验证结果、PR 号、遗留问题。
- **不碰 local main、不建 / 删 worktree**——那是 Leader 的活。

## 本项目是什么

一套面向智能体的深度推理引擎规则集:三套引擎,每套一中一英两个文件、内容一一对应。

| 引擎 | 面向模型 | 中文 | 英文 |
|------|---------|------|------|
| 无限推理引擎 Infinite-Reasoning | DeepSeek V4 Pro | `dsv4proMaxThinkingRules_cn.md` | `dsv4proMaxThinkingRules.md` |
| 极速推理引擎 Rapid-Reasoning | DeepSeek V4 Flash | `dsv4flashMaxThinkingRules_cn.md` | `dsv4flashMaxThinkingRules.md` |
| 锐利推理引擎 Incisive-Reasoning | GLM 5.1 | `glm51MaxThinkingRules_cn.md` | `glm51MaxThinkingRules.md` |

规则正文是**直接注入 system prompt 的提示词**,不是给人读的说明文:不写「TODO」「见 docs/xxx」这类元信息,不带维护者视角的叙述。

## 硬约束

- **一套引擎一个文件,不合并、不抽公共片段**:三套引擎各自针对对应模型的短板设计,改一套不得顺手改另两套,三条规则文件之间不共享内容。
- **章节骨架固定**:`# 角色` → `## 核心指令` → `## 思维架构执行`(四步)→ 独有协议(有则单列一个 `##`)→ `## 执行约束` → `## 输出隔离原则` → `## 输出指令`。可以改内容,但不改顺序、不改章节名。
- **四步思维架构的名称固定**:解构与前提审计 / 多视角综合 / 第三层 / 反驳与压力测试。第三层是引擎专属叫法——Pro 用「无限深度遍历」、Flash 用「快速螺旋深化」、GLM 用「递进深化」,不得跨引擎移植。
- **独有协议不得跨引擎移植**:反捷径协议只属于 Flash;独立判断协议 + 反浅层收敛协议只属于 GLM;Pro 没有独有协议。同理,轮次下限(Flash 至少三轮、GLM 至少三层)、GLM 的「语言一致性」约束也都是引擎专属。README 两版的对比表已固化这些差异,移植等于让文档说谎。
- **输出隔离原则是最高优先级,措辞不许弱化**:五条(思考过程不可见 / 标题隔离 / 元认知不可见 / 纯粹回答 / 无例外原则)一条都不能删、不能改软,三套引擎这一节保持等价。
- **中文版与英文版同轮改**:任何规则内容改动必须在同一次提交里改完 `_cn.md` 与英文版,条款数、协议名、约束条数一一对应;只改一边算未完成。英文按地道美式英语写,不逐字硬译。
- **README 两版跟着改**:`README.md` / `README_cn.md` 的「三大推理引擎对比」表格与正文(独有模块、轮次下限、条数、语言一致性标记)描述的是规则文件的现状,规则改了这里必须同轮同步。
- `docs/` 下是评测体系规划(题目 / 实验组 / 对照组 / 评审),不是规则文本;改规则不碰 `docs/`。

## 验证

改完跑下面这段,每对文件的两个数字必须相等(当前基线:Pro 5 个 `##` / 9 条 `*`,Flash 6 / 14,GLM 7 / 18):

```bash
for b in dsv4proMaxThinkingRules dsv4flashMaxThinkingRules glm51MaxThinkingRules; do
echo "$b cn: $(grep -c '^## ' ${b}_cn.md)/$(grep -c '^\* ' ${b}_cn.md) en: $(grep -c '^## ' ${b}.md)/$(grep -c '^\* ' ${b}.md)"
done
```

- 数字变了就同步更新这里的基线,别让基线漂成假的。
- 关键短语对账:三套文件都应有输出隔离原则(中文 `grep -c '输出隔离原则'`、英文 `grep -c 'Output Isolation Principle'` 各为 1);独有协议名(`反捷径协议` / `独立判断协议` / `反浅层收敛协议`)只应出现在对应引擎的文件里。

## 详细说明

`README.md` / `README_cn.md`(三套引擎的定位与差异)、`CONTRIBUTING_cn.md`(贡献约定)、`docs/`(评测规划);通用工作规则见全局 `~/.pi/agent/AGENTS.md`。
6 changes: 6 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this

## [未发布]

### 新增(`.pi/APPEND_SYSTEM.md`:Worker 会话的项目硬规则)

- **为什么改**:用户 2026-11-07 定下全局 Leader / Worker 分工——子项目的具体活由以子项目根 / worktree 为工作目录的 Worker 会话承担,Leader 只做 local main 同步、建 worktree、派活与收尾。Worker 会话读不到 Agent 项目那一层的上下文,本仓特有的硬规则必须落在本仓,由 pi 在会话启动时自动追加进系统提示;否则 Worker 只能靠 Leader 口头交代,规则随任务结束即丢失。
- **改了什么**(2026-11-07):新增 `.pi/APPEND_SYSTEM.md`(50 行)。只写本项目特有的约束:Worker 角色边界(不碰 local main、不建 / 删 worktree)、规则正文是注入 system prompt 的提示词而非说明文、一套引擎一个文件不合并不抽公共片段、章节骨架与四步思维架构名称固定、独有协议与轮次下限 / 语言一致性不得跨引擎移植、输出隔离五条不许弱化、中英同轮改、README 对比表同步;末尾附可直接跑的核对命令与当前基线(Pro 5 个 `##` / 9 条 `*`,Flash 6 / 14,GLM 7 / 18)。通用身份与全局规则仍由 `AGENTS.md` 软链接提供,此处不重述。
- **边界**:不改任何规则文件与 README,纯新增一份会话层配置;`.pi/` 是 pi 的配置目录,`APPEND_SYSTEM.md` 属其白名单内的「追加系统提示」文件(见全局 `~/.pi/agent/AGENTS.md` 的 `.pi/` 白名单条)。

### 变更(移除访问量徽章,配合停用集中式流量采集)

- **为什么改**:用户 2026-11-04 决定停用 xhqing 仓库的集中式访问量采集,同时不再在各仓库 README 展示访问量徽章。徽章的数据源必须由采集任务每天刷新,采集停掉之后徽章会冻结在旧值,而徽章文案写的是「Visits/day (14d)」——数字不再更新却仍显示成实时数据,留着反而误导读者。
Expand Down
Loading