From b5a6493c76b61f2be4ac3cd940e2a1652f97d3e3 Mon Sep 17 00:00:00 2001 From: bottlefish <781230111@qq.com> Date: Wed, 25 Feb 2026 00:07:41 +0800 Subject: [PATCH] =?UTF-8?q?docs(agent):=20=E6=B8=90=E8=BF=9B=E5=BC=8F?= =?UTF-8?q?=E8=AF=BB=E5=8F=96=E8=A7=84=E5=88=99=E4=B8=8E=20SKILL=20?= =?UTF-8?q?=E5=90=8C=E6=AD=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- .cursor/skills/inbox-directive/SKILL.md | 9 ++++++--- .cursor/skills/inbox-discussion/SKILL.md | 4 +++- .cursor/skills/inbox-proposal/SKILL.md | 4 ++++ AGENTS.md | 11 +++++++++++ 4 files changed, 24 insertions(+), 4 deletions(-) diff --git a/.cursor/skills/inbox-directive/SKILL.md b/.cursor/skills/inbox-directive/SKILL.md index 5d97a40..1d24a75 100644 --- a/.cursor/skills/inbox-directive/SKILL.md +++ b/.cursor/skills/inbox-directive/SKILL.md @@ -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`。 diff --git a/.cursor/skills/inbox-discussion/SKILL.md b/.cursor/skills/inbox-discussion/SKILL.md index 39792bd..1acc0f4 100644 --- a/.cursor/skills/inbox-discussion/SKILL.md +++ b/.cursor/skills/inbox-discussion/SKILL.md @@ -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 层全文按需）。 diff --git a/.cursor/skills/inbox-proposal/SKILL.md b/.cursor/skills/inbox-proposal/SKILL.md index 77db32c..950e6c9 100644 --- a/.cursor/skills/inbox-proposal/SKILL.md +++ b/.cursor/skills/inbox-proposal/SKILL.md @@ -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 与冲突点）、讨论记录可留空。 diff --git a/AGENTS.md b/AGENTS.md index babf830..196da2a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,6 +16,17 @@ 6. **模板为聚合服务，结构随信息而定**：模板用于更好地聚合与检索；具体条目可根据实际聚合到的信息，选择适合的小节与呈现方式（例如无冲突则冲突表可留空，回忆角色可弱化机制、强化弧线/意象），不必机械填满模板每一项。 7. **不物理删除**：AI 没有删除文件的权限。若 Inbox 或人类要求「删掉设定/角色/节拍 X」，一律按**废弃**处理：将对应条目的 `status` 改为 `archived` 或 `deprecated`；具体流程见 `inbox-directive` SKILL 的「废弃处理」；**绝不物理删除**文件。 8. **自然语言介绍与 SSOT 同步**：每当 SSOT（权威设定详情）发生重大变更（如核心矛盾、身份、生死状态变化）时，必须检查并重写该条目的「自然语言介绍」部分，避免介绍老化。 +9. **渐进式读取**：读 kb 时按下方「渐进式读取」三层递进；Bible 新建/更新时 frontmatter 须含 `summary`。 + +### 渐进式读取（三层） + +读 kb 时按层递进，不全量读全文。适用范围：`kb/bible/角色/`、`kb/bible/设定/`、`kb/beats/`。 + +| 层 | 内容 | 用途 | +|----|------|------| +| **第 1 层（YAML）** | 只读各文件 frontmatter（约前 15 行）。用 `id`、`summary`、`characters`、`terms`、`related_characters`、`related_worldbuilding` | 判断与当前任务相关的文件 | +| **第 2 层（自然语言介绍）** | 对判定为相关的文件，只读到「自然语言介绍」结束（不读权威设定详情、冲突、changelog） | 快速理解实体；多数讨论/提案到此即可 | +| **第 3 层（全文）** | 读该文件全文（含 SSOT、冲突、changelog） | 需要精确设定、修改 SSOT、或查冲突/变更记录时 | ## 目录结构