项目指令与提示词规范 (Markdown)

JeikCode 深度内建了多层级的 Markdown 规则与模板体系，帮助团队将工程架构规范、提问自动包装与上下文永久记忆持久化到项目中。

---

1. 项目规范指令文件 (AGENTS.md / .jeikcode.md)

1.1 文件定位与最高裁量权

项目指令文件用于固化团队专有的编码风格、分支规范、架构约束与测试流程：

• 存放位置：位于项目工作区根目录下的 <workspace>/AGENTS.md（推荐）或 <workspace>/.jeikcode.md；
• 最高裁量权 (Precedence)：凡是在项目规范文件中声明的规则，在 Agent 进行代码生成、架构重构或决策时，严格优先于 System 默认规则。

1.2 注入机制与 KV Cache 稳定性

• 会话首部紧凑注入：在会话启动时，系统会将项目规范一次性合并注入至系统提示词首部；
• 楼板保护 (sacred_floor)：项目规范受底层楼板保护，在多轮对话以及上下文压缩剪枝（/compact）时永不丢失，同时保障各大模型厂商 Prompt Caching 前缀的字节级稳定性。

1.3 一键初始化 (/init)

在终端中输入斜杠命令：

/init

JeikCode 会自动扫描当前工作区的语言类型、依赖包、构建与测试命令，并自动生成第一份标准化的项目指令文件。

---

2. 用户提问包装模板 (user-wrap.md)

user-wrap.md 允许你定义一个全局或项目级的 Prompt 模板，在每一次向模型发送提问时自动包裹你的输入内容。

2.1 存放位置与优先级

1. 项目级：./.jeikcode/user-wrap.md（仅当前工程生效，优先级最高）；
2. 全局级：~/.jeikcode/user-wrap.md（对所有工程生效）。

2.2 核心语法与 {{input}} 占位符

模板文件中必须包含 {{input}} 占位符。你在终端或 WebUI 中敲下的真实提问会被动态替换至该位置：

请扮演顶级资深架构师。针对以下用户需求进行解答：

{{input}}

## 硬性交付约束
1. 所有修改的代码必须附带清晰的注释；
2. 保持向后兼容，严禁进行未授权的破坏性重构；
3. 输出结果请统一使用简体中文。

2.3 即时热重载

user-wrap.md 采用基于文件修改时间戳（mtime）的动态监听机制。保存修改后立即生效，无需重启进程或会话。

---

3. 永久记忆事实库 (memory.md)

记忆机制用于跨会话固化不易变更的核心技术事实、私有镜像源地址或个人偏好。

3.1 存放位置与记录方式

• 文件位置：用户全局级 ~/.jeikcode/memory.md 与项目级；
• 快速记录命令：在交互终端中执行：

  /remember 本项目所有 API 响应统一包装在 ApiResponse<T> 结构中

  或者直接使用编辑器修改 memory.md。

3.2 上下文保护

记忆内容作为 synthetic User 消息注入到会话的不可变前缀区，受 sacred_floor 保护。无论会话持续了多少轮次，或者经历多次 /compact 智能剪枝，记忆内容始终牢固保存在 Agent 的上下文记忆中。