diff --git a/.pi/APPEND_SYSTEM.md b/.pi/APPEND_SYSTEM.md new file mode 100644 index 0000000..8771e97 --- /dev/null +++ b/.pi/APPEND_SYSTEM.md @@ -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`。 diff --git a/CHANGELOG.md b/CHANGELOG.md index eb78f8f..de847c7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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)」——数字不再更新却仍显示成实时数据,留着反而误导读者。