docs(agent): 渐进式读取规则与 SKILL 同步

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-02-25 00:07:41 +08:00
co-authored by Cursor
parent 4c4bcc3b3c
commit b5a6493c76
4 changed files with 24 additions and 4 deletions
+6 -3
View File
@@ -7,12 +7,15 @@ description: Use when 指令、按此修改 SSOT、直接落地、处理 inbox
**直接修改 SSOT**(更新/新建 bible 与 beat),然后归档。通用约束见 **AGENTS.md**
读 kb 时遵循 **AGENTS.md** 之「渐进式读取」(第 1 层 YAML → 第 2 层自然语言介绍 → 第 3 层全文按需);新建/更新 Bible 时 frontmatter 须含 `summary`
## A. 处理 Inbox 文件(指令路径)
### 阶段一(只读,不修改任何文件)
1. 识别实体(角色、设定、节拍),对每个判断操作(更新/新建/废弃)
2. 输出分析报告,**等人确认**。报告须含:
1. **按渐进式读取**:第 1 层确定涉及实体,第 2 层理解实体,需改 SSOT 时再第 3 层
2. 识别实体(角色、设定、节拍),对每个判断操作(更新/新建/废弃)。
3. 输出分析报告,**等人确认**。报告须含:
- **涉及实体**:角色 / 设定 / Beat 列表
- **建议操作表**:| 实体 | 类型 | 操作 | 具体内容 | 是否有冲突 |
- **待人确认项**(冲突裁决、新建是否符合预期等)
@@ -37,7 +40,7 @@ description: Use when 指令、按此修改 SSOT、直接落地、处理 inbox
## B. 采纳提案(如「采纳 P-001」)
1. **重读**:读该提案全文。
2. **重验**扫描相关 Bible/Beat,看与现有一致性、是否有新冲突。
2. **重验**按渐进式读取(AGENTS.md)先第 1 层判定相关文件,再第 2/3 层精读提案 `targets` 所列及相关 Bible/Beat,看与现有一致性、是否有新冲突。
3. **报告**:若影响分析过时则说明当前影响;否则简要确认。
4. **执行**:用户确认后,合并入 SSOT、更新 changelog;提案移入 `proposals/archive/`(项目根),`status: accepted`。
+3 -1
View File
@@ -5,4 +5,6 @@ description: Use when 讨论、头脑风暴、信息收集、探索想法、还
# 讨论
用户选择**讨论**或未明确指令/提案时:只做信息收集与对话,不修改 `kb/`,不创建提案、不写 SSOT。需要落地时再请用户标明「提案」或「指令」,再走 **inbox-proposal****inbox-directive**
`kb/` 查询信息时:只做信息收集与对话,不修改 `kb/`,不创建提案、不写 SSOT。需要落地时再请用户标明「提案」或「指令」,再走 **inbox-proposal****inbox-directive**
读 kb 时遵循 **AGENTS.md** 之「渐进式读取」(第 1 层 YAML → 第 2 层自然语言介绍 → 第 3 层全文按需)。
+4
View File
@@ -7,6 +7,10 @@ description: Use when 提案、想法进提案库、inbox 标为提案、仅写
**不修改 SSOT**。将内容写入项目根 `proposals/`,填写 `targets` 指向涉及的 Bible/Beat;对应页面底部由 Dataview 展示「关联提案」。
读 kb 时遵循 **AGENTS.md** 之「渐进式读取」(第 1 层 YAML → 第 2 层自然语言介绍 → 第 3 层全文按需);写「初始影响分析」时通常第 2 层即可。
## 步骤
1. **创建提案文件**:从 `template/tpl-proposal.md` 复制到 `proposals/P-{序号}_{简短标题}.md`(项目根),序号取未占用最小三位数。
2. **frontmatter**`targets`wikilink 数组,如 `[[kb/bible/角色/佩佩]]``[[kb/beats/佩佩-维修1]]`)、`summary`(与核心创意一致的一句话)。
3. **正文**:核心创意、详细内容、**初始影响分析**(基于当前 kb,列出可能受影响的 Beat/Bible 与冲突点)、讨论记录可留空。