diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/SKILL.md index ee3cf23b1..f1b5c1ed8 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/SKILL.md @@ -456,7 +456,7 @@ description: 写游戏策划案（GDD）系统架构时使用。在顶层设计 → 没有变更记录的架构文档，第二轮迭代就会变成黑箱。 ### 2. 系统地图 -Sxx 编号清单（核心系统 2~12 个）+ 支撑层（存档/UI，不拥有核心规则）。 +Sxx 编号清单（核心系统通常 1-5 个，有明确要求可超出 5 个）+ 支撑层（存档/UI，不拥有核心规则）。 P0 段五列表： | 系统 | 目的 | 输入 | 输出 | P0 原因 | → 每行 P0 原因必须答"删了它，__ 塌"；答不出的降级或合并。 @@ -544,7 +544,7 @@ P1/P2 可用能力表（能力/说明）控制颗粒度。 --- name: game-gdd-system-doc -description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二节同构骨架、 +description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二类常见内容、 红线与分析文档格式。每类系统的专属写法与模板在 01~12 各文件夹的 SKILL.md 与 模板.md 里，按需取用。 --- @@ -594,7 +594,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 咬合：**对上**服从架构三条合同（编号/职责/依赖）；**对内**状态与接口不越 职责边界；**对下**第 7 节交接喂 TDD。 -## 四、十二节通用写法 +## 四、常见内容的参考写法 （各系统类型的特殊写法见对应文件夹 SKILL.md；纯净模板在其 模板.md） 1 系统目的：若删除它，__ 会塌——一句话说不出 = 该系统不该存在。 @@ -607,7 +607,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 8 反馈：每种关键结果给独立反馈形态；失败必须说明原因和恢复路径。 9 内部循环：动词链；可拆单次/区域/长期三层。 10 输入输出与依赖：引用具名系统与具名数据，禁泛称"资源"。 -11 边界与非目标：照该类型 skill 的"三不"写全；必含"字段数值归 TDD"一条。 +11 边界与非目标：参考该类型 skill 的“三不”说明边界；建议说明字段与数值的交接边界。 12 开放问题：结构级才留；手感数值类标"待原型验证"。 ## 五、分析文档（全局一份，按层分节） @@ -1190,7 +1190,7 @@ description: 写游戏策划案（GDD）系统架构时使用。在顶层设计 → 没有变更记录的架构文档，第二轮迭代就会变成黑箱。 ### 2. 系统地图 -Sxx 编号清单（核心系统 2~12 个）+ 支撑层（存档/UI，不拥有核心规则）。 +Sxx 编号清单（核心系统通常 1-5 个，有明确要求可超出 5 个）+ 支撑层（存档/UI，不拥有核心规则）。 P0 段五列表： | 系统 | 目的 | 输入 | 输出 | P0 原因 | → 每行 P0 原因必须答"删了它，__ 塌"；答不出的降级或合并。 @@ -1280,7 +1280,7 @@ P1/P2 可用能力表（能力/说明）控制颗粒度。 --- name: game-gdd-system-doc -description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二节同构骨架、 +description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二类常见内容、 红线与分析文档格式。每类系统的专属写法与模板在 01~12 各文件夹的 SKILL.md 与 模板.md 里，按需取用。 --- @@ -1330,7 +1330,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 咬合：**对上**服从架构三条合同（编号/职责/依赖）；**对内**状态与接口不越 职责边界；**对下**第 7 节交接喂 TDD。 -## 四、十二节通用写法 +## 四、常见内容的参考写法 （各系统类型的特殊写法见对应文件夹 SKILL.md；纯净模板在其 模板.md） 1 系统目的：若删除它，__ 会塌——一句话说不出 = 该系统不该存在。 @@ -1343,7 +1343,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 8 反馈：每种关键结果给独立反馈形态；失败必须说明原因和恢复路径。 9 内部循环：动词链；可拆单次/区域/长期三层。 10 输入输出与依赖：引用具名系统与具名数据，禁泛称"资源"。 -11 边界与非目标：照该类型 skill 的"三不"写全；必含"字段数值归 TDD"一条。 +11 边界与非目标：参考该类型 skill 的“三不”说明边界；建议说明字段与数值的交接边界。 12 开放问题：结构级才留；手感数值类标"待原型验证"。 ## 五、分析文档（全局一份，按层分节） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/systems.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/systems.md index 4985625f9..50c44335c 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/systems.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/systems.md @@ -2,7 +2,7 @@ --- name: game-gdd-system-doc -description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二节同构骨架、 +description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二类常见内容、 红线与分析文档格式。每类系统的专属写法与模板在 modules/system-types/ 下对应目录的 SKILL.md 与对应模块的模板.md 里，按需取用。 --- @@ -28,7 +28,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 的判定部分），读取对应的 `SKILL.md` 与 `模板.md`。 3. 该文件夹标注"参考例子"的，可先读例子了解写法。 -## 三、十二节总览：写什么、为什么、怎么咬合 +## 三、常见内容总览：写什么、为什么、怎么咬合 系统文档回答四个问题： **这个系统为什么存在（1~2）→ 玩家怎么用它（3~5）→ 它怎么运转（6~8）→ @@ -52,7 +52,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 咬合：**对上**服从架构三条合同（编号/职责/依赖）；**对内**状态与接口不越 职责边界；**对下**第 7 节交接喂 TDD。 -## 四、十二节通用写法 +## 四、常见内容的参考写法 （各系统类型的特殊写法见对应文件夹 SKILL.md；纯净模板在其 模板.md） 1 系统目的：若删除它，__ 会塌——一句话说不出 = 该系统不该存在。 @@ -65,7 +65,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 8 反馈：每种关键结果给独立反馈形态；失败必须说明原因和恢复路径。 9 内部循环：动词链；可拆单次/区域/长期三层。 10 输入输出与依赖：引用具名系统与具名数据，禁泛称"资源"。 -11 边界与非目标：照该类型 skill 的"三不"写全；必含"字段数值归 TDD"一条。 +11 边界与非目标：参考该类型 skill 的“三不”说明边界；建议说明字段与数值的交接边界。 12 开放问题：结构级才留；手感数值类标"待原型验证"。 ## 五、分析文档（全局一份，按层分节）