diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/overview-card.md b/apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/overview-card.md index 801255760..8754cf2cc 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/overview-card.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/phase-context/overview-card.md @@ -1,4 +1,4 @@ -概念阶段定稿时，创建或更新速览卡。下面是速览卡的参考结构；根据游戏类型、项目规模和用户要求选择适用字段，同类内容可以合并，复杂项目可以增加必要字段。表格和列表中的示例行按实际对象逐行扩展： +概念阶段定稿时，创建或更新 `project/速览卡.md`。下面是速览卡的参考结构；根据游戏类型、项目规模和用户要求选择适用字段，同类内容可以合并，复杂项目可以增加必要字段。表格和列表中的示例行按实际对象逐行扩展： # 速览卡：《游戏名》 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 4a5ae9af5..981b5f77f 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 @@ -137,14 +137,15 @@ description: 写游戏策划案（GDD）概念层时使用。把一句话游戏 不放分析文档——本文件只放已决论证与登记。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准两问：① 什么是本项目不可替代的核心承诺；② 什么内容扩张会稀释它。 - 数量纪律：概念期问题通常 ≤3；开始堆第 4 问时先怀疑概念层没想清楚，重读定调记录而不是继续开新争议。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 @@ -321,14 +322,15 @@ __（多短一段玩法体现独有乐趣——原型只做这一个单位）。 不放分析文档——本文件只放已决论证与登记。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准两问：① 一天/一局怎样形成清楚但不拖沓的循环；② 风险、收益与长期成长怎样互相支撑。 - 数量纪律：顶层期问题通常 ≤5（结构性争议天然更多）；堆问题时先回读第 1 节定位句。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 @@ -486,14 +488,15 @@ P1/P2 可用能力表（能力/说明）控制颗粒度。 不放分析文档——本文件只放已决论证与登记。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准问题：结构级争议——接口统一、系统归并、主数据归属划分。 - 数量纪律：按需；架构期问题多为接口与归属二义。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 @@ -584,14 +587,15 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 不放分析文档——本文件只放已决论证与登记。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准问题：① 本系统与相邻系统的边界在哪；② 本系统内部哪个规则影响顶层取舍。条目标系统号（如 S06）。 - 数量纪律：按需；每系统通常 0~1 条，超了先回读架构职责表。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 @@ -839,14 +843,15 @@ description: 写游戏策划案（GDD）概念层时使用。把一句话游戏 不放分析文档——本文件只放已决论证与登记。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准两问：① 什么是本项目不可替代的核心承诺；② 什么内容扩张会稀释它。 - 数量纪律：概念期问题通常 ≤3；开始堆第 4 问时先怀疑概念层没想清楚，重读定调记录而不是继续开新争议。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 @@ -1025,14 +1030,15 @@ __（多短一段玩法体现独有乐趣——原型只做这一个单位）。 不放分析文档——本文件只放已决论证与登记。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准两问：① 一天/一局怎样形成清楚但不拖沓的循环；② 风险、收益与长期成长怎样互相支撑。 - 数量纪律：顶层期问题通常 ≤5（结构性争议天然更多）；堆问题时先回读第 1 节定位句。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 @@ -1192,14 +1198,15 @@ P1/P2 可用能力表（能力/说明）控制颗粒度。 不放分析文档——本文件只放已决论证与登记。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准问题：结构级争议——接口统一、系统归并、主数据归属划分。 - 数量纪律：按需；架构期问题多为接口与归属二义。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 @@ -1292,14 +1299,15 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 不放分析文档——本文件只放已决论证与登记。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准问题：① 本系统与相邻系统的边界在哪；② 本系统内部哪个规则影响顶层取舍。条目标系统号（如 S06）。 - 数量纪律：按需；每系统通常 0~1 条，超了先回读架构职责表。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/decision-log.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/decision-log.md index b0ec9d25b..b4ad33295 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/decision-log.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/decision-log.md @@ -3,7 +3,7 @@ 版本：v3　|　规则：台账放活队列——design 只放结论、分析只放论证、决定与开放问题住这里。编号连续不复用；被推翻的行标 overturned 挂新行，不删行。 状态六态：`confirmed`（用户亲口/亲选）/ `auto_decided`（技术类代决，必带理由＋推翻条件，用户一键可翻）/ `default_pending`（默认建议兜底，用户未点头）/ `prototype_pending`（待原型验证）/ `pending_user`（等用户拍板）/ `overturned`（被推翻，挂旧行编号）。 -> 编号口径：前面各项与全局分析登记一致；其中若干为"就地小权衡，直接登记未开条目"，此处按登记口径展开。后续项在技术文档期新增，并与开放问题回执互引。 +> 编号口径：D-01~D-13 与 templates/stardew-analysis.md 台账节选一致（D-04~D-06、D-08~D-10、D-12 原为"就地小权衡，直接登记未开条目"，此处按登记口径展开）；D-14 起为技术文档期新增，与 stardew-tdd-tech.md 开放问题回执互引。 ## 当前待办（活队列） @@ -11,20 +11,20 @@ | 编号 | 决定 | 层 | 谁 | 依据 | 推翻条件 | 状态 | |---|---|---|---|---|---|---| -| 体力共享 | 体力与战斗共享单池 | TDD | user | 风险资源统一制造取舍（概念张力一）；**暂按共享实现，改单拆只需改 S02 成本入口** | 战斗参与率实测过低（玩家回避矿井） | pending_user（暂按共享实现） | -| 背包容量 | 背包格子制 vs 重量制 | TDD | user | 格子制直觉、重量制焦虑感与 T5"休闲不打卡"冲突；暂按格子制实现、存档预留 capacity_type 字段 | 格子管理成为主要负面反馈 | pending_user（B 级阻断存档结构，暂按格子制） | +| D-14 | 体力与战斗共享单池 | TDD | user | 风险资源统一制造取舍（概念张力一）；**暂按共享实现，改单拆只需改 S02 成本入口** | 战斗参与率实测过低（玩家回避矿井） | pending_user（暂按共享实现） | +| D-15 | 背包格子制 vs 重量制 | TDD | user | 格子制直觉、重量制焦虑感与 T5"休闲不打卡"冲突；暂按格子制实现、存档预留 capacity_type 字段 | 格子管理成为主要负面反馈 | pending_user（B 级阻断存档结构，暂按格子制） | ### 待原型验证（prototype_pending） | 编号 | 决定 | 层 | 谁 | 依据 | 推翻条件 | 状态 | |---|---|---|---|---|---|---| -| 判定手感 | 战斗判定窗口手感（前摇帧数/无敌帧 450ms 基准） | 系统 | user | 数值可定、手感不可纸面验证 | 原型显示节奏拖慢/玩家困惑 | prototype_pending（规则本体见 战斗判定 confirmed） | +| D-13b | 战斗判定窗口手感（前摇帧数/无敌帧 450ms 基准） | 系统 | user | 数值可定、手感不可纸面验证 | 原型显示节奏拖慢/玩家困惑 | prototype_pending（规则本体见 D-13 confirmed） | ### 默认建议兜底（default_pending） | 编号 | 决定 | 层 | 谁 | 依据 | 推翻条件 | 状态 | |---|---|---|---|---|---|---| -| 天气数值 | 天气权重表具体数值（晴/雨/风暴按季节） | TDD | agent | 概念层只定"雨免浇水"定性；数值推内容期填 | 前 5 日出现连续 3 日雨/全无雨 | default_pending（默认值已进数据表，带 designer_note） | +| D-19 | 天气权重表具体数值（晴/雨/风暴按季节） | TDD | agent | 概念层只定"雨免浇水"定性；数值推内容期填 | 前 5 日出现连续 3 日雨/全无雨 | default_pending（默认值已进数据表，带 designer_note） | ## 已采用决定 @@ -32,35 +32,35 @@ | 编号 | 决定 | 层 | 谁 | 依据 | 推翻条件 | 状态 | |---|---|---|---|---|---|---| -| 基调定位 | 定调：牧场物语系参照、治愈慢节奏 | 概念 | user | 用户原始需求 | — | confirmed | -| 范围约束 | 单人体验，无多人 | 概念 | user | 概念层非目标 | — | confirmed | -| 战斗定位 | 战斗保持伴生风险，不做装备驱动主轴 | 概念 | user | 概念期问题一 | 矿井流失率过半且归因战斗 | confirmed | -| 日目标 | 日目标自设，季节与社区提供低频牵引 | 顶层 | user | 顶层期问题一 | 新手周流失归因无方向 | confirmed | -| 活动接口 | 采集/钓鱼/战斗统一"活动结果"接口 | 架构 | user | 架构期问题一 | 第三活动类型出现结构性差异 | confirmed | -| 战斗判定 | 战斗采用节奏/指令判定 | 系统 | user | S06 问题一 | 原型显示节奏拖慢/玩家困惑 | confirmed（手感部分拆 判定手感 prototype_pending） | +| D-01 | 定调：牧场物语系参照、治愈慢节奏 | 概念 | user | 用户原始需求 | — | confirmed | +| D-02 | 单人体验，无多人 | 概念 | user | 概念层非目标 | — | confirmed | +| D-03 | 战斗保持伴生风险，不做装备驱动主轴 | 概念 | user | 概念期问题一 | 矿井流失率过半且归因战斗 | confirmed | +| D-07 | 日目标自设，季节与社区提供低频牵引 | 顶层 | user | 顶层期问题一 | 新手周流失归因无方向 | confirmed | +| D-11 | 采集/钓鱼/战斗统一"活动结果"接口 | 架构 | user | 架构期问题一 | 第三活动类型出现结构性差异 | confirmed | +| D-13 | 战斗采用节奏/指令判定 | 系统 | user | S06 问题一 | 原型显示节奏拖慢/玩家困惑 | confirmed（手感部分拆 D-13b prototype_pending） | ### 技术代决（auto_decided——带理由与推翻条件，用户一键可翻） | 编号 | 决定 | 层 | 谁 | 依据（理由） | 推翻条件 | 状态 | |---|---|---|---|---|---|---| -| 时间片 | 时间片制：700ms=10 游戏分钟 | 概念 | agent | 原作实证节拍；一天≈14 分钟真实时间贴合 T5"休闲" | 内测一天体感过短/过长 | auto_decided | -| 区域切换 | 分区域切换（区域独立场景，非连续地图） | 概念 | agent | 概念层"不是什么：无边界开放世界"；区域小网络全部步行可达 | 场景切换成为移动负担反馈 | auto_decided | -| 季节周期 | 28 日/季、四季/年 | 顶层 | agent | 季节窗口制造"本季计划"节奏（支柱二） | 换季频率在测试中被无视 | auto_decided | -| 营业条件 | 商店营业时段走条件表 | 架构 | agent | 与配方/区域解锁共用 check(condition_id) 单一入口 | 条件表规模膨胀难维护 | auto_decided | -| 日终结算 | 出货箱日终统一结算 | 架构 | agent | 收入集中进日终面板，强化"一天一结算"叙事；商店现卖保留即时通道 | 玩家普遍绕开出货箱 | auto_decided | -| 工具占用 | 工具升级期间该工具不可用 | 系统 | agent | 升级=时间成本换效率（顶层张力二）；备用旧工具暂不做（开放问题） | 升级期挫败感集中爆发 | auto_decided | -| 矿井生成 | 矿井逐层生成本期不做（P2） | TDD | agent | GDD 已标"不做无限地牢"；首期按布局池 8~12 模板拼装 | 内测要求深度爬塔玩法 | auto_decided | -| 换装范围 | 换装首期 5 层（基础体/裤/衣/发型/饰件），非 19 层 | TDD | agent | 外观自定义非首期卖点；层结构预留到 19 层 | 外观系统成核心诉求 | auto_decided | -| 品质三档 | 作物品质三档：普通/银/金 | TDD | agent | 经济分层需要（即时变现 vs 等待升值的取舍） | 银金档无人区分、一律普通出售 | auto_decided | +| D-04 | 时间片制：700ms=10 游戏分钟 | 概念 | agent | 原作实证节拍；一天≈14 分钟真实时间贴合 T5"休闲" | 内测一天体感过短/过长 | auto_decided | +| D-05 | 分区域切换（区域独立场景，非连续地图） | 概念 | agent | 概念层"不是什么：无边界开放世界"；区域小网络全部步行可达 | 场景切换成为移动负担反馈 | auto_decided | +| D-06 | 28 日/季、四季/年 | 顶层 | agent | 季节窗口制造"本季计划"节奏（支柱二） | 换季频率在测试中被无视 | auto_decided | +| D-09 | 商店营业时段走条件表 | 架构 | agent | 与配方/区域解锁共用 check(condition_id) 单一入口 | 条件表规模膨胀难维护 | auto_decided | +| D-10 | 出货箱日终统一结算 | 架构 | agent | 收入集中进日终面板，强化"一天一结算"叙事；商店现卖保留即时通道 | 玩家普遍绕开出货箱 | auto_decided | +| D-12 | 工具升级期间该工具不可用 | 系统 | agent | 升级=时间成本换效率（顶层张力二）；备用旧工具暂不做（开放问题） | 升级期挫败感集中爆发 | auto_decided | +| D-16 | 矿井逐层生成本期不做（P2） | TDD | agent | GDD 已标"不做无限地牢"；首期按布局池 8~12 模板拼装 | 内测要求深度爬塔玩法 | auto_decided | +| D-17 | 换装首期 5 层（基础体/裤/衣/发型/饰件），非 19 层 | TDD | agent | 外观自定义非首期卖点；层结构预留到 19 层 | 外观系统成核心诉求 | auto_decided | +| D-18 | 作物品质三档：普通/银/金 | TDD | agent | 经济分层需要（即时变现 vs 等待升值的取舍） | 银金档无人区分、一律普通出售 | auto_decided | ### 已推翻（overturned——旧行保留，挂新行） | 编号 | 决定 | 层 | 谁 | 依据 | 推翻条件 | 状态 | |---|---|---|---|---|---|---| -| 早期品质两档 | 作物品质两档：普通/银 | TDD | agent | 早期小权衡：两档最简 | — | **overturned → 品质三档**（经济分层不足，改三档；铱档留 P1） | +| D-08 | 作物品质两档：普通/银 | TDD | agent | 早期小权衡：两档最简 | — | **overturned → D-18**（经济分层不足，改三档；铱档留 P1） | ## 队列纪律（使用说明） -- 新决定入队：取下一个可用登记编号，并保持连续不复用；就现代决可登记不开条目，但状态必须写 auto_decided 并带理由＋推翻条件。 +- 新决定入队：拿下一号（当前最大 D-19，下一号 D-20）；就现代决可登记不开条目，但状态必须写 auto_decided 并带理由＋推翻条件。 - 用户翻案：旧行标 overturned 挂新行，受影响文档节重写（本台账只记录，不代改）。 - 概念层变更定稿后：速览卡"决定状态与原型验证项"字段随本文件最新版同步。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/overview-card.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/overview-card.md index 3d1bf962d..68a55e87f 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/overview-card.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/overview-card.md @@ -52,8 +52,8 @@ Web 浏览器运行 · 双视口（桌面/移动）· 键鼠/触屏双输入 · - 达标再扩展：玩家能自述明日计划后，才加社交深度与矿井分层。 ## 12. 决定状态与原型验证项（依据决策台账） -- 已确认（confirmed）：总体基调 / 单人范围 / 战斗伴生 / 日目标自设 / 活动统一接口 / 战斗节奏判定。 -- 技术代决（auto_decided，可一键翻案）：时间片 / 区域切换 / 季节周期 / 营业条件 / 日终结算 / 工具占用 / 矿井生成 P2 / 换装 5 层 / 品质三档（推翻早期品质两档）。 -- 等拍板（pending_user）：体力战斗是否共享单池（暂按共享实现）；背包格子/重量（暂按格子制，B 级阻断存档结构）。 -- 待原型（prototype_pending）：战斗判定窗口手感（前摇帧数/450ms 无敌帧基准）。 -- 默认兜底（default_pending）：天气权重数值（默认已入表，带 designer_note）。 +- 已确认（confirmed）：定调 D-01 / 单人 D-02 / 战斗伴生 D-03 / 日目标自设 D-07 / 活动统一接口 D-11 / 战斗节奏判定 D-13。 +- 技术代决（auto_decided，可一键翻案）：D-04 时间片 / D-05 分区域切换 / D-06 28 日季 / D-09 营业条件 / D-10 出货箱日终 / D-12 工具占用 / D-16 矿井生成 P2 / D-17 换装 5 层 / D-18 品质三档（推翻 D-08 两档）。 +- 等拍板（pending_user）：D-14 体力战斗是否共享单池（暂按共享实现）；D-15 背包格子/重量（暂按格子制，B 级阻断存档结构）。 +- 待原型（prototype_pending）：D-13b 战斗判定窗口手感（前摇帧数/450ms 无敌帧基准）。 +- 默认兜底（default_pending）：D-19 天气权重数值（默认已入表，带 designer_note）。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-architecture.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-architecture.md index c31ba1f04..b81f74342 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-architecture.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-architecture.md @@ -8,7 +8,7 @@ > 玩家在有限的时间与体力下，通过农场、探索与社交三组活动系统产出资源与关系，经物品与经济系统转化为投资，由时间系统推进日终，把一天的成果变成下一天的选择。 变更记录： -- 2026-09-05：战斗与敌人系统定为伴生风险定位，深度刻意受限，不进入最小闭环核心链（依据：概念分析 战斗定位）。 +- 2026-09-05：战斗与敌人系统定为伴生风险定位，深度刻意受限，不进入最小闭环核心链（依据：概念分析 D-03）。 ## 系统地图 @@ -66,7 +66,7 @@ P0 段： 负责一天制的节奏规则：什么时候推进日期、哪些系统收到跨天 tick、日终结算何时发生。它不负责奖励结算，也不负责作物成长规则——只负责"什么时候"和"谁被通知"。 ### S06 战斗与敌人系统 -负责战斗内状态、敌人行为与战利品请求。它不直接修改商店价格或 NPC 好感，不负责角色长期成长；战利品只提交请求，由 S07 物品系统入账。定位是矿井探索的风险与节奏变化，不是成长主轴（战斗定位）。 +负责战斗内状态、敌人行为与战利品请求。它不直接修改商店价格或 NPC 好感，不负责角色长期成长；战利品只提交请求，由 S07 物品系统入账。定位是矿井探索的风险与节奏变化，不是成长主轴（D-03）。 ### S07 物品、背包与制作系统 负责物品身份、容器、堆叠与配方队列。它是全项目的公共语言层——任何系统的产出都以 `item_id` 入账；它不负责物品的经济价值平衡，价格只由 S09 维护。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-art-bible.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-art-bible.md index 3f774a412..87ecd930c 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-art-bible.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-art-bible.md @@ -77,6 +77,6 @@ | # | 问题 | 去向 | |---|---|---| -| 1 | 换装系统首期是否做全 19 层（或缩到 5 层） | → 台账代决（建议首期 5 层：基础体/裤/衣/发型/饰件；台账 换装范围） | +| 1 | 换装系统首期是否做全 19 层（或缩到 5 层） | → 台账代决（建议首期 5 层：基础体/裤/衣/发型/饰件；台账 D-17） | | 2 | 锚点图方向需用户确认 | → 施工期提案卡 | | 3 | 位图字体 vs 矢量像素风字体 | → 小批阶段随 UI 套件定 | diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-tech.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-tech.md index a688eca27..64481d930 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-tech.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-tech.md @@ -116,7 +116,7 @@ | 需求 | 用什么 | 来源与版本 | 实例化参数 | |---|---|---|---| -| Web 游戏开发规范 | 浏览器游戏开发规范 | 当前版 | 双视口/双输入/本地预览/纯 HTML 交付 | +| Web 游戏开发规范 | agc-web-game-development | `skill@当前版` | 双视口/双输入/本地预览/纯 HTML 交付 | | 地图渲染 | Canvas 2D 自研渲染器 | 手写（JSON 地图数据） | 四层结构（对齐原作 xTile 层语义） | | 音频 | 原生 WebAudio | 浏览器内置 API | BGM/SFX 双通道 | @@ -124,9 +124,9 @@ | 项 | 规定 | 依据 | |---|---|---| -| 瓦片地图结构 | 16px 网格；农场 80×65、小镇 50×40、矿井按层生成 | 台账 区域切换（区域分场景，非连续地图） | +| 瓦片地图结构 | 16px 网格；农场 80×65、小镇 50×40、矿井按层生成 | 台账 D-05（区域分场景，非连续地图） | | 镜头 | 跟随玩家+边界钳制；无缩放（固定整数倍） | GDD 顶层（无镜头玩法） | -| 场景切换 | 农场↔小镇↔矿井走连接点淡入淡出 ≤1s | 概念 区域切换 定案"分区域切换" | +| 场景切换 | 农场↔小镇↔矿井走连接点淡入淡出 ≤1s | 概念 D-05 定案"分区域切换" | | 关卡数据 | `data/maps/*.json`（自定义 JSON：层/网格/对象点） | 契约 v2 | ## 输入与操作 @@ -167,6 +167,6 @@ | # | 问题 | 去向 | |---|---|---| -| 1 | 背包格子还是重量容量（影响存档与 UI 结构） | → 概念层决策卡（B 级阻断，台账 背包容量） | -| 2 | 矿井逐层生成是否本期做 | → 台账代决（建议 P2，GDD 已标"不做无限地牢"；台账 矿井生成） | -| 3 | 体力是否与战斗共享单池 | → 台账 体力共享（B 级待拍，暂按共享实现） | +| 1 | 背包格子还是重量容量（影响存档与 UI 结构） | → 概念层决策卡（B 级阻断，台账 D-15） | +| 2 | 矿井逐层生成是否本期做 | → 台账代决（建议 P2，GDD 已标"不做无限地牢"；台账 D-16） | +| 3 | 体力是否与战斗共享单池 | → 台账 D-14（B 级待拍，暂按共享实现） | diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-art-bible-SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-art-bible-SKILL.md index 5b596f99d..0aaf5924d 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-art-bible-SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-art-bible-SKILL.md @@ -1,12 +1,12 @@ --- name: game-tdd-02-art-bible description: 写"美术圣经"（美术侧）分册时使用。与总纲（技术文档层总纲分册）配套。 - 读者：美术 / 素材生产。 + 配套模板：templates/tdd-art-bible.md。配套金样：exemplars/stardew-tdd-art-bible.md。读者：美术 / 素材生产。 --- # 美术圣经 · 美术侧写法（策划 · TDD 分册之二） -> 本文件承载美术侧的写作流程。 +> 本文件承载美术侧的写作流程；模板在 templates/tdd-art-bible.md（保持纯净），金样在 exemplars/stardew-tdd-art-bible.md。 ## 一、这一件的判断立场 @@ -33,7 +33,7 @@ description: 写"美术圣经"（美术侧）分册时使用。与总纲（技 对象（资产总清单的范围）、物品表（item_id 绑定依据，数据侧已定）、 可复用画风规范。 2. 本件在数据侧表结构定稿后开写（素材清单引用 item_id）。 -3. 读取对应金样了解契约表与资产状态表包含的信息类型（同层只读一次）。 +3. 读取金样 exemplars/stardew-tdd-art-bible.md 了解契约表与资产状态表包含的信息类型（同层只读一次）。 ## 三、怎么写（模板即流程，按节） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-data-SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-data-SKILL.md index 0b178e483..3eefe8b8c 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-data-SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-data-SKILL.md @@ -1,13 +1,14 @@ --- name: game-tdd-03-data-config description: 写"数据与配表"（数据侧）分册时使用。与总纲（技术文档层总纲分册）配套。 + 配套模板：templates/tdd-data.md。配套金样：exemplars/stardew-tdd-data.md。 底料：归 TDD 素材两份提取件（S06 数值结构＋架构字段字典，随包附件）。 读者：数值策划 + 程序。 --- # 数据与配表 · 数据侧写法（策划 · TDD 分册之三） -> 本文件承载数据侧的写作流程。 +> 本文件承载数据侧的写作流程；模板在 templates/tdd-data.md（保持纯净），金样在 exemplars/stardew-tdd-data.md。 > 两份提取件是本件的现成实料：引用规则、示例表、验收七查直接改造成文。 ## 一、这一件的判断立场 @@ -33,7 +34,7 @@ description: 写"数据与配表"（数据侧）分册时使用。与总纲（ （架构层的定性基准，在本件落成前 N 日验算）。 2. 先读两份提取件：字段字典全套规则与验收模板已在那里成文，本件是 项目实例化，不是重新发明。 -3. 读取对应金样了解数据清单、验算表与验收结论包含的信息类型（同层只读一次）。 +3. 读取金样 exemplars/stardew-tdd-data.md 了解数据清单、验算表与验收结论包含的信息类型（同层只读一次）。 ## 三、怎么写（模板即流程，按节） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-tech-SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-tech-SKILL.md index a358d41e2..9602213ca 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-tech-SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/tdd-tech-SKILL.md @@ -1,12 +1,12 @@ --- name: game-tdd-01-tech description: 写"技术实现"（程序侧）分册时使用。与总纲（技术文档层总纲分册）配套。 - 读者：工程师。 + 配套模板：templates/tdd-tech.md。配套金样：exemplars/stardew-tdd-tech.md。读者：工程师。 --- # 技术实现 · 程序侧写法（策划 · TDD 分册之一） -> 本文件承载程序侧的写作流程。 +> 本文件承载程序侧的写作流程；模板在 templates/tdd-tech.md（保持纯净），金样在 exemplars/stardew-tdd-tech.md。 ## 一、这一件的判断立场 @@ -28,7 +28,7 @@ description: 写"技术实现"（程序侧）分册时使用。与总纲（技 1. 输入齐了吗：架构层系统范围表+P0 清单（拆模块依据）、数据侧表结构契约 （加载与校验要引用）、可复用能力选型（实现类需求先查现成能力，不自造轮子）。 2. 读总纲判断立场；本件在数据侧表结构定稿后开写。 -3. 读取对应金样了解技术实现文档包含的信息类型（同层只读一次）。 +3. 读取金样 exemplars/stardew-tdd-tech.md 了解技术实现文档包含的信息类型（同层只读一次）。 ## 三、怎么写（模板即流程，按节） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/01_核心玩法编排/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/01_核心玩法编排/SKILL.md index 81c77fd7c..0194f6120 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/01_核心玩法编排/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/01_核心玩法编排/SKILL.md @@ -1,8 +1,9 @@ -### C2 01_核心玩法编排 · 系统写法 +### C2 01_核心玩法编排/SKILL.md（→ modules/system-types/01_核心玩法编排/SKILL.md） --- name: gdd-sys-01-orchestration -description: 写"核心玩法/日循环编排"类系统文档时使用。 +description: 写"核心玩法/日循环编排"类系统文档时使用。与 skills/systems.md + 配套（通用纪律不在此重复）。配套模板：modules/system-types/01_核心玩法编排/模板.md。 --- # 核心玩法编排 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/01_核心玩法编排/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/01_核心玩法编排/模板.md index 9cd4e875f..614b9acca 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/01_核心玩法编排/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/01_核心玩法编排/模板.md @@ -1,4 +1,4 @@ -### C2 01_核心玩法编排 · 模板 +### C2 01_核心玩法编排/模板.md（→ modules/system-types/01_核心玩法编排/模板.md） # __系统：S__（核心玩法编排类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/02_时间与日程/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/02_时间与日程/SKILL.md index 4eae39bd7..8fcbc2d6f 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/02_时间与日程/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/02_时间与日程/SKILL.md @@ -1,8 +1,9 @@ -### C2 02_时间与日程 · 系统写法 +### C2 02_时间与日程/SKILL.md（→ modules/system-types/02_时间与日程/SKILL.md） --- name: gdd-sys-02-time-schedule -description: 写"时间与日程"类系统文档时使用。 +description: 写"时间与日程"类系统文档时使用。与 skills/systems.md 配套。 + 配套模板：modules/system-types/02_时间与日程/模板.md。 --- # 时间与日程 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/02_时间与日程/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/02_时间与日程/模板.md index e94c82c13..5225e8ff4 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/02_时间与日程/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/02_时间与日程/模板.md @@ -1,4 +1,4 @@ -### C2 02_时间与日程 · 模板 +### C2 02_时间与日程/模板.md（→ modules/system-types/02_时间与日程/模板.md） # __系统：S__（时间与日程类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/03_生产种植经营/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/03_生产种植经营/SKILL.md index 9b62fe526..98d0e87e1 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/03_生产种植经营/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/03_生产种植经营/SKILL.md @@ -1,8 +1,9 @@ -### C2 03_生产种植经营 · 系统写法 +### C2 03_生产种植经营/SKILL.md（→ modules/system-types/03_生产种植经营/SKILL.md） --- name: gdd-sys-03-farm-production -description: 写"生产/种植经营"类系统文档时使用。 +description: 写"生产/种植经营"类系统文档时使用。与 skills/systems.md 配套。 + 配套模板：modules/system-types/03_生产种植经营/模板.md。 --- # 生产种植经营 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/03_生产种植经营/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/03_生产种植经营/模板.md index af55e3a22..81c0341fe 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/03_生产种植经营/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/03_生产种植经营/模板.md @@ -1,4 +1,4 @@ -### C2 03_生产种植经营 · 模板 +### C2 03_生产种植经营/模板.md（→ modules/system-types/03_生产种植经营/模板.md） # __系统：S__（生产种植经营类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/04_地图与探索/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/04_地图与探索/SKILL.md index 1c991acde..cca360aa9 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/04_地图与探索/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/04_地图与探索/SKILL.md @@ -1,8 +1,9 @@ -### C2 04_地图与探索 · 系统写法 +### C2 04_地图与探索/SKILL.md（→ modules/system-types/04_地图与探索/SKILL.md） --- name: gdd-sys-04-map-exploration -description: 写"地图与探索"类系统文档时使用。 +description: 写"地图与探索"类系统文档时使用。与 skills/systems.md 配套。 + 配套模板：modules/system-types/04_地图与探索/模板.md。 --- # 地图与探索 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/04_地图与探索/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/04_地图与探索/模板.md index 5af7b454c..5129075c0 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/04_地图与探索/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/04_地图与探索/模板.md @@ -1,4 +1,4 @@ -### C2 04_地图与探索 · 模板 +### C2 04_地图与探索/模板.md（→ modules/system-types/04_地图与探索/模板.md） # __系统：S__（地图与探索类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/05_采集与支线活动/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/05_采集与支线活动/SKILL.md index c29a2c125..8aaa8fbae 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/05_采集与支线活动/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/05_采集与支线活动/SKILL.md @@ -1,8 +1,9 @@ -### C2 05_采集与支线活动 · 系统写法 +### C2 05_采集与支线活动/SKILL.md（→ modules/system-types/05_采集与支线活动/SKILL.md） --- name: gdd-sys-05-gathering-activities description: 写"采集与支线活动"类系统文档（采集/钓鱼/挖矿等侧挂轻活动）时使用。 + 与 skills/systems.md 配套。配套模板：modules/system-types/05_采集与支线活动/模板.md。 --- # 采集与支线活动 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/05_采集与支线活动/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/05_采集与支线活动/模板.md index 33e6f2548..f2bc9a509 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/05_采集与支线活动/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/05_采集与支线活动/模板.md @@ -1,4 +1,4 @@ -### C2 05_采集与支线活动 · 模板 +### C2 05_采集与支线活动/模板.md（→ modules/system-types/05_采集与支线活动/模板.md） # __系统：S__（采集与支线活动类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/06_战斗与敌人/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/06_战斗与敌人/SKILL.md index 40b7359a8..88ca94814 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/06_战斗与敌人/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/06_战斗与敌人/SKILL.md @@ -1,8 +1,9 @@ -### C2 06_战斗与敌人 · 系统写法 +### C2 06_战斗与敌人/SKILL.md（→ modules/system-types/06_战斗与敌人/SKILL.md） --- name: gdd-sys-06-combat -description: 写"战斗与敌人"类系统文档时使用。 +description: 写"战斗与敌人"类系统文档时使用。与 skills/systems.md 配套。 + 配套模板：modules/system-types/06_战斗与敌人/模板.md。 --- # 战斗与敌人 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/06_战斗与敌人/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/06_战斗与敌人/模板.md index fb9799353..cb583d10f 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/06_战斗与敌人/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/06_战斗与敌人/模板.md @@ -1,4 +1,4 @@ -### C2 06_战斗与敌人 · 模板 +### C2 06_战斗与敌人/模板.md（→ modules/system-types/06_战斗与敌人/模板.md） # __系统：S__（战斗与敌人类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/07_物品背包与制作/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/07_物品背包与制作/SKILL.md index a3cc3b8c7..3e8bc760c 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/07_物品背包与制作/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/07_物品背包与制作/SKILL.md @@ -1,8 +1,9 @@ -### C2 07_物品背包与制作 · 系统写法 +### C2 07_物品背包与制作/SKILL.md（→ modules/system-types/07_物品背包与制作/SKILL.md） --- name: gdd-sys-07-items-crafting -description: 写"物品、背包与制作"类系统文档时使用。 +description: 写"物品、背包与制作"类系统文档时使用。与 skills/systems.md 配套。 + 配套模板：modules/system-types/07_物品背包与制作/模板.md。 --- # 物品、背包与制作 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/07_物品背包与制作/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/07_物品背包与制作/模板.md index 260c2568a..7330baac0 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/07_物品背包与制作/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/07_物品背包与制作/模板.md @@ -1,4 +1,4 @@ -### C2 07_物品背包与制作 · 模板 +### C2 07_物品背包与制作/模板.md（→ modules/system-types/07_物品背包与制作/模板.md） # __系统：S__（物品、背包与制作类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/08_成长与技能/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/08_成长与技能/SKILL.md index 55447af11..1bad1bf92 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/08_成长与技能/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/08_成长与技能/SKILL.md @@ -1,8 +1,9 @@ -### C2 08_成长与技能 · 系统写法 +### C2 08_成长与技能/SKILL.md（→ modules/system-types/08_成长与技能/SKILL.md） --- name: gdd-sys-08-progression -description: 写"成长与技能"类系统文档时使用。 +description: 写"成长与技能"类系统文档时使用。与 skills/systems.md 配套。 + 配套模板：modules/system-types/08_成长与技能/模板.md。 --- # 成长与技能 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/08_成长与技能/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/08_成长与技能/模板.md index 670facf35..61502e11c 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/08_成长与技能/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/08_成长与技能/模板.md @@ -1,4 +1,4 @@ -### C2 08_成长与技能 · 模板 +### C2 08_成长与技能/模板.md（→ modules/system-types/08_成长与技能/模板.md） # __系统：S__（成长与技能类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/09_NPC关系与任务/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/09_NPC关系与任务/SKILL.md index edf63ee9c..24b13c8dc 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/09_NPC关系与任务/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/09_NPC关系与任务/SKILL.md @@ -1,8 +1,9 @@ -### C2 09_NPC关系与任务 · 系统写法 +### C2 09_NPC关系与任务/SKILL.md（→ modules/system-types/09_NPC关系与任务/SKILL.md） --- name: gdd-sys-09-npc-quest description: 写"NPC、关系与任务"类系统文档时使用（覆盖关系与任务两个职责）。 + 与 skills/systems.md 配套。配套模板：modules/system-types/09_NPC关系与任务/模板.md。 --- # NPC、关系与任务 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/09_NPC关系与任务/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/09_NPC关系与任务/模板.md index fdb9d9fd7..5c8154289 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/09_NPC关系与任务/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/09_NPC关系与任务/模板.md @@ -1,4 +1,4 @@ -### C2 09_NPC关系与任务 · 模板 +### C2 09_NPC关系与任务/模板.md（→ modules/system-types/09_NPC关系与任务/模板.md） # __系统：S__（NPC、关系与任务类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/10_经济与商店/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/10_经济与商店/SKILL.md index 366eb865f..f33cffb10 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/10_经济与商店/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/10_经济与商店/SKILL.md @@ -1,8 +1,9 @@ -### C2 10_经济与商店 · 系统写法 +### C2 10_经济与商店/SKILL.md（→ modules/system-types/10_经济与商店/SKILL.md） --- name: gdd-sys-10-economy-shop -description: 写"经济与商店"类系统文档时使用。 +description: 写"经济与商店"类系统文档时使用。与 skills/systems.md 配套。 + 配套模板：modules/system-types/10_经济与商店/模板.md。 --- # 经济与商店 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/10_经济与商店/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/10_经济与商店/模板.md index 6112f31d2..49d2e04ec 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/10_经济与商店/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/10_经济与商店/模板.md @@ -1,4 +1,4 @@ -### C2 10_经济与商店 · 模板 +### C2 10_经济与商店/模板.md（→ modules/system-types/10_经济与商店/模板.md） # __系统：S__（经济与商店类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/11_事件与节日/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/11_事件与节日/SKILL.md index cee3def12..f311ce52b 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/11_事件与节日/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/11_事件与节日/SKILL.md @@ -1,8 +1,9 @@ -### C2 11_事件与节日 · 系统写法 +### C2 11_事件与节日/SKILL.md（→ modules/system-types/11_事件与节日/SKILL.md） --- name: gdd-sys-11-events-festivals -description: 写"事件与节日"类系统文档时使用。 +description: 写"事件与节日"类系统文档时使用。与 skills/systems.md 配套。 + 配套模板：modules/system-types/11_事件与节日/模板.md。 --- # 事件与节日 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/11_事件与节日/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/11_事件与节日/模板.md index b187cd7f9..fb185c168 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/11_事件与节日/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/11_事件与节日/模板.md @@ -1,4 +1,4 @@ -### C2 11_事件与节日 · 模板 +### C2 11_事件与节日/模板.md（→ modules/system-types/11_事件与节日/模板.md） # __系统：S__（事件与节日类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/12_UI与文本呈现/SKILL.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/12_UI与文本呈现/SKILL.md index 456eac729..4b1d2e979 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/12_UI与文本呈现/SKILL.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/12_UI与文本呈现/SKILL.md @@ -1,8 +1,9 @@ -### C2 12_UI与文本呈现 · 系统写法 +### C2 12_UI与文本呈现/SKILL.md（→ modules/system-types/12_UI与文本呈现/SKILL.md） --- name: gdd-sys-12-ui-text -description: 写"UI 与文本呈现"类系统文档时使用。 +description: 写"UI 与文本呈现"类系统文档时使用。与 skills/systems.md 配套。 + 配套模板：modules/system-types/12_UI与文本呈现/模板.md。 --- # UI 与文本呈现 · 系统写法 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/12_UI与文本呈现/模板.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/12_UI与文本呈现/模板.md index 7e6c304d9..edc9dc909 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/12_UI与文本呈现/模板.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/modules/system-types/12_UI与文本呈现/模板.md @@ -1,4 +1,4 @@ -### C2 12_UI与文本呈现 · 模板 +### C2 12_UI与文本呈现/模板.md（→ modules/system-types/12_UI与文本呈现/模板.md） # __系统：S__（UI 与文本呈类） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/architecture.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/architecture.md index 5b53da5e2..f33f15cfb 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/architecture.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/architecture.md @@ -4,7 +4,8 @@ name: game-gdd-architecture description: 写游戏策划案（GDD）系统架构时使用。在顶层设计定稿之后， 把顶层的系统范围表正式切成 Sxx 系统：编号、职责、依赖、数据流、优先级， - 并向系统文档交付目录映射与 MVP 闭环。 + 并向系统文档交付目录映射与 MVP 闭环。配套：templates/architecture.md、 + templates/analysis.md（全局一份）、exemplars/stardew-architecture.md、templates/stardew-analysis.md（全局一份）。 --- # 系统架构写法（策划 · 系统架构分册） @@ -30,7 +31,8 @@ description: 写游戏策划案（GDD）系统架构时使用。在顶层设计 ## 二、动笔前 1. 顶层设计已定稿可用——把它的**系统范围表**（粗清单）和**顶层定稿约束** 摊开当输入；切分是对粗清单的正式化（拆、并、裁都在这层做）。 -2. 读取对应示例了解内容组织方式，然后按对应模板填写。 +2. 读取 exemplars/stardew-architecture.md 了解内容组织方式， + 然后往 templates/architecture.md 里填。 3. 记住顶层的核心循环图——切完必须跑覆盖检查。 ## 三、架构设计的组织维度：写什么、为什么、怎么咬合 @@ -76,7 +78,7 @@ description: 写游戏策划案（GDD）系统架构时使用。在顶层设计 三方一致、主数据归属唯一；**对下**目录映射 + MVP 闭环喂系统文档。 ## 四、怎么写（模板参考结构，建议按此组织） -（本节是带写法要领的教学版；实际填写使用对应纯净模板。） +（本节是带写法要领的教学版；实际填写的纯净模板在 templates/architecture.md） ### 1. 架构定位与目标 本阶段确定"哪些系统支撑一轮玩法"，不展开单系统内部规则。 @@ -137,17 +139,21 @@ P1/P2 可用能力表（能力/说明）控制颗粒度。 ## 五、分析文档（全局一份，按层分节） -**全局共用一份分析文档**：论证按发生层归节，决定登记表全项目共用，跨层引用只查这里。已决论证与登记写入分析文档，灵感池、代决、待原型等活队列写入决策台账。 +**全局共用 `project/analysis.md`**：论证按发生层归节，决定登记表全项目共用， +跨层引用查这里。模板与例子：资源 `templates/analysis.md`、 +`templates/stardew-analysis.md`。已决论证与登记写入分析文档， +灵感池、代决、待原型等活队列写入决策台账。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准问题：结构级争议——接口统一、系统归并、主数据归属划分。 - 数量纪律：按需；架构期问题多为接口与归属二义。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/concept.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/concept.md index faf90d3ab..b2e8b1fb2 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/concept.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/concept.md @@ -4,7 +4,8 @@ name: game-gdd-concept description: 写游戏策划案（GDD）概念层时使用。把一句话游戏想法写成一份 "一次写对、之后不动"的立项概念文档——它是后续所有设计争议的仲裁依据。 - 任何游戏类型通用。 + 任何游戏类型通用。配套：templates/concept-design.md、templates/analysis.md（全局一份）、 + exemplars/stardew-concept.md、templates/stardew-analysis.md（全局一份）。 --- # 概念层写法（策划 · 概念层分册） @@ -30,7 +31,8 @@ description: 写游戏策划案（GDD）概念层时使用。把一句话游戏 ## 二、动笔前 1. 拿到用户真实回答过的定调信息（参照对象、题材偏好、压力档位）。 没有 → 先问一个定调问题，禁止自问自答充当用户。 -2. 读取对应示例了解内容组织方式，然后按对应模板填写。 +2. 读取 exemplars/stardew-concept.md 了解内容组织方式， + 然后往 templates/concept-design.md 里填。 3. 零参照时在文档头注明"零参照"。 ## 三、概念设计的组织维度：写什么、为什么、怎么咬合 @@ -72,7 +74,7 @@ description: 写游戏策划案（GDD）概念层时使用。把一句话游戏 **对上**边界画线防止越层。九节不是清单，是一台咬合的机器。 ## 四、怎么写（模板参考结构，建议按此组织） -（本节是带写法要领的教学版；实际填写使用对应纯净模板。） +（本节是带写法要领的教学版；实际填写的纯净模板在 templates/concept-design.md） ### 1. 一句话概念 《__》是一款 __（品类与融合）：玩家通过 __，把 __ 逐步 __。 @@ -131,17 +133,21 @@ description: 写游戏策划案（GDD）概念层时使用。把一句话游戏 ## 五、分析文档（全局一份，按层分节） -**全局共用一份分析文档**：论证按发生层归节，决定登记表全项目共用，跨层引用只查这里。已决论证与登记写入分析文档，灵感池、代决、待原型等活队列写入决策台账。 +**全局共用 `project/analysis.md`**：论证按发生层归节，决定登记表全项目共用， +跨层引用查这里。模板与例子：资源 `templates/analysis.md`、 +`templates/stardew-analysis.md`。已决论证与登记写入分析文档， +灵感池、代决、待原型等活队列写入决策台账。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准两问：① 什么是本项目不可替代的核心承诺；② 什么内容扩张会稀释它。 - 数量纪律：概念期问题通常 ≤3；开始堆第 4 问时先怀疑概念层没想清楚，重读定调记录而不是继续开新争议。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 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 76c0f64ce..d361488b4 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 @@ -3,12 +3,14 @@ --- name: game-gdd-system-doc description: 写单个系统的设计文档（Sxx）时的总纲——通用纪律、十二类常见内容、 - 红线与分析文档格式。 + 红线与分析文档格式。每类系统的专属写法与模板在 modules/system-types/ 下对应目录的 SKILL.md + 与对应模块的模板.md 里，按需取用。 --- # 系统文档写法（策划 · 系统文档分册 · 总纲） -> 本文件是系统文档层的总纲；通用纪律不在各系统写法里重复。 +> 本文件是系统文档层的总纲；各系统的专属写法在 `modules/system-types/` 下对应目录的 `SKILL.md`， + 专属模板在 `modules/system-types/` 对应目录的 `模板.md`。通用纪律不在各系统 skill 里重复。 ## 〇、结构适配原则 @@ -26,7 +28,8 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 ## 二、动笔前 1. 架构已定稿：找到本系统的 Sxx 编号、职责表行、依赖方向——这是合同。 -2. 选择最接近的系统类型（可组合，如"钓鱼"=采集+战斗的判定部分），使用对应的系统写法与模板。 +2. 在 01~12 文件夹里选最接近的系统类型（可组合，如"钓鱼"=05 采集+06 战斗 + 的判定部分），读取对应的 `SKILL.md` 与 `模板.md`。 3. 该文件夹标注"参考例子"的，可先读例子了解写法。 ## 三、常见内容总览：写什么、为什么、怎么咬合 @@ -54,7 +57,7 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 职责边界；**对下**第 7 节交接喂 TDD。 ## 四、常见内容的参考写法 -（各系统类型的特殊写法与纯净模板按对应类型取用。） +（各系统类型的特殊写法见对应文件夹 SKILL.md；纯净模板在其 模板.md） 1 系统目的：若删除它，__ 会塌——一句话说不出 = 该系统不该存在。 2 支撑体验：对应顶层目标第__条、调性原则第__条。 @@ -71,17 +74,21 @@ description: 写单个系统的设计文档（Sxx）时的总纲——通用纪 ## 五、分析文档（全局一份，按层分节） -**全局共用一份分析文档**：论证按发生层归节，决定登记表全项目共用，跨层引用只查这里。已决论证与登记写入分析文档，灵感池、代决、待原型等活队列写入决策台账。 +**全局共用 `project/analysis.md`**：论证按发生层归节，决定登记表全项目共用， +跨层引用查这里。模板与例子：资源 `templates/analysis.md`、 +`templates/stardew-analysis.md`。已决论证与登记写入分析文档， +灵感池、代决、待原型等活队列写入决策台账。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准问题：① 本系统与相邻系统的边界在哪；② 本系统内部哪个规则影响顶层取舍。条目标系统号（如 S06）。 - 数量纪律：按需；每系统通常 0~1 条，超了先回读架构职责表。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/tdd.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/tdd.md index fadd678ac..9a9ca73af 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/tdd.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/tdd.md @@ -100,16 +100,16 @@ GDD 喂的（系统文档交接节就是订单）；程序侧的加载与验证 ## A1 概念层分册（简介） -本分册说明概念设计的目标、边界、核心张力、分析记录和交接要求。完整内容见对应分册与模板。 +本分册说明概念设计的目标、边界、核心张力、分析记录和交接要求。完整内容请阅读 `resources/skills/concept.md`；概念设计模板请阅读 `resources/templates/concept-design.md`。 ## A2 顶层设计分册（简介） -本分册说明顶层循环、资源流、节奏、取舍、范围和验证标准。完整内容见对应分册与模板。 +本分册说明顶层循环、资源流、节奏、取舍、范围和验证标准。完整内容请阅读 `resources/skills/top_design.md`；顶层设计模板请阅读 `resources/templates/top-design.md`。 ## A3 系统架构分册（简介） -本分册说明系统职责、依赖、数据归属、MVP 闭环、目录映射和架构校验。完整内容见对应分册与模板。 +本分册说明系统职责、依赖、数据归属、MVP 闭环、目录映射和架构校验。完整内容请阅读 `resources/skills/architecture.md`；架构模板请阅读 `resources/templates/architecture.md`。 ## A4 系统文档分册（简介） -本分册说明单个系统的职责、规则、输入输出、反馈、边界、验证和分析记录。完整内容见对应分册；系统类型的专属写法和模板按需取用对应类型。 +本分册说明单个系统的职责、规则、输入输出、反馈、边界、验证和分析记录。完整内容请阅读 `resources/skills/systems.md`；系统类型的专属写法和模板请按需阅读 `modules/system-types/` 下对应分册。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/top_design.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/top_design.md index 067e72c8e..cfd2439d7 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/top_design.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/skills/top_design.md @@ -4,7 +4,8 @@ name: game-gdd-top-design description: 写游戏策划案（GDD）顶层设计时使用。在概念层定稿之后， 回答"玩家为什么一直玩"——把概念变成可玩的时间结构（循环/资源/取舍/节奏）， - 并向架构层交付系统范围。 + 并向架构层交付系统范围。配套：templates/top-design.md、templates/analysis.md（全局一份）、 + exemplars/stardew-top-design.md、templates/stardew-analysis.md（全局一份）。 --- # 顶层设计写法（策划 · 顶层设计分册） @@ -28,8 +29,9 @@ description: 写游戏策划案（GDD）顶层设计时使用。在概念层定 - 你不替概念层翻案（张力与定稿已定），也不替架构层拆系统（只划边界）。 ## 二、动笔前 -1. 概念层结论文档已定稿可用——顶层定位与取舍表直接从它长出来。 -2. 读取对应示例了解内容组织方式，然后按对应模板填写。 +1. 概念层 design.md 已定稿可用——顶层定位与取舍表直接从它长出来。 +2. 读取 exemplars/stardew-top-design.md 了解内容组织方式， + 往 templates/top-design.md 里填。 3. 把概念层已确认的核心张力作为输入；存在对应取舍时再挂上编号。 ## 三、顶层设计的组织维度：写什么、为什么、怎么咬合 @@ -83,7 +85,7 @@ description: 写游戏策划案（GDD）顶层设计时使用。在概念层定 顶层定稿当架构的紧箍咒、验证标准当原型试玩判据。 ## 四、怎么写（模板参考结构，建议按此组织） -（本节是带写法要领的教学版；实际填写使用对应纯净模板。） +（本节是带写法要领的教学版；实际填写的纯净模板在 templates/top-design.md） ### 1. 顶层定位与规模锚点 承接概念定稿说明核心定位；存在容易混淆的方向时，说明排除方向及理由，表述按项目需要组织。 @@ -160,17 +162,21 @@ __（多短一段玩法体现独有乐趣——原型只做这一个单位）。 ## 五、分析文档（全局一份，按层分节） -**全局共用一份分析文档**：论证按发生层归节，决定登记表全项目共用，跨层引用只查这里。已决论证与登记写入分析文档，灵感池、代决、待原型等活队列写入决策台账。 +**全局共用 `project/analysis.md`**：论证按发生层归节，决定登记表全项目共用， +跨层引用查这里。模板与例子：资源 `templates/analysis.md`、 +`templates/stardew-analysis.md`。已决论证与登记写入分析文档， +灵感池、代决、待原型等活队列写入决策台账。 - 条目格式：`## 问题：<一句话>` ＋ 状态（agent_proposal / user_confirmed / - superseded，登记编号：__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 + superseded，登记 D-__）＋ 广度分析（牵动面＋候选 ≥2）＋ 深度分析 （逐候选利弊依据，必须引 T 原则/锚点/张力编号，写不出依据的偏好不进分析） ＋ 综合判断（建议取 __ 因为 __；推翻条件：__）。 - 分诊三条件全满足才进：① 影响项目方向或边界；② ≥2 合理候选；③ 一时定不了。 不满足的：就地小权衡直接进登记表一行，不写条目。 - 本层标准两问：① 一天/一局怎样形成清楚但不拖沓的循环；② 风险、收益与长期成长怎样互相支撑。 - 数量纪律：顶层期问题通常 ≤5（结构性争议天然更多）；堆问题时先回读第 1 节定位句。 -- user_confirmed 后三件事：结论一句话迁入对应结论文档节（留修订痕迹）；登记表加行（编号全项目连续，跨层引用写登记编号）；本条目保留原状态记录不删。 +- user_confirmed 后三件事：结论一句话迁入 design.md 对应节（留修订痕迹）； + 登记表加行（编号全项目连续，跨层引用写 D-__）；本条目改状态记 D 号保留不删。 推翻时新增行挂旧行编号，旧行不删。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/analysis.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/analysis.md index 7b34ce3a4..56ec881d8 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/analysis.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/analysis.md @@ -1,4 +1,4 @@ -### C1 分析模板（全局一份） +### C1 模板_分析.md（全局一份；→ templates/analysis.md） # 分析：《游戏名》 @@ -10,7 +10,7 @@ ## 概念期问题（通常 ≤3 条） ## 问题：__（一句话） -状态：agent_proposal / user_confirmed / superseded（登记编号：__） +状态：agent_proposal / user_confirmed / superseded（登记 D-__） - 广度分析：牵动面（波及哪些锚点/张力/节）＋ 候选方向（≥2） - 深度分析：逐候选 利/弊/依据（必须引定调记录 T 原则、锚点、张力编号或参照资料，写不出依据的偏好不进分析） - 综合判断：建议取 __，因为 __。推翻条件：__。 @@ -35,7 +35,7 @@ | D# | 决定 | 层 | 权威 | 依据 | 推翻条件 | 状态 | |---|---|---|---|---|---|---| -| __ | __ | 概念 | user / agent（代决带理由） | 本文件问题__ / T__ | __ | 已确认/已推翻/待原型 | +| D-01 | __ | 概念 | user / agent（代决带理由） | 本文件问题__ / T__ | __ | 已确认/已推翻/待原型 | -- 登记编号全项目连续；跨层引用直接写登记编号；推翻时新增行挂旧行编号，旧行不删。 +- 编号全项目连续；跨层引用直接写"D-__"；推翻时新增行挂旧行编号，旧行不删。 - 就地小权衡（不满足分诊三条件的）直接登记一行，不写问题条目。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/architecture.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/architecture.md index 4e0840f0c..e6d8d5e85 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/architecture.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/architecture.md @@ -1,4 +1,4 @@ -### C1 系统架构模板 +### C1 模板_系统架构.md（→ templates/architecture.md） 本模板是参考结构，不是固定清单。只有需要独立职责、状态或数据边界的部分才拆成系统；简单项目可以合并系统和章节，复杂项目可以增加必要的系统与校验。表格中的示例行可按实际系统、风险和问题扩展，不代表数量上限。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/concept-design.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/concept-design.md index d5747c313..36fc4dc79 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/concept-design.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/concept-design.md @@ -1,4 +1,4 @@ -### C1 概念设计模板 +### C1 模板_概念设计.md（→ templates/concept-design.md） 本模板是参考结构，不是固定清单。填写前按项目类型、规模和用户要求筛选章节与字段；同类内容可合并，若某节对项目没有实际意义则删除，复杂项目可增加必要内容。表格和列表中的示例项可按实际内容扩展，不代表数量上限。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/stardew-analysis.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/stardew-analysis.md index 4c51b7828..a08d153c6 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/stardew-analysis.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/stardew-analysis.md @@ -1,4 +1,4 @@ -### C1 星露谷分析示例（分析金样） +### C1 例子_星露谷_分析.md（分析金样；→ templates/stardew-analysis.md） # 分析：《星露谷物语》 @@ -8,7 +8,7 @@ ## 概念期问题 ## 问题：矿井战斗要不要做成装备驱动的成长主轴？ -状态：user_confirmed（登记 战斗定位） +状态：user_confirmed（登记 D-03） - 广度分析：牵动锚点"目标体验"（掌控感与紧张的比例）、"不是什么"表第 3 行、核心张力第 3 条（稳定经营 vs 未知探索）。候选：A 战斗做成装备驱动主轴之一；B 战斗保持伴生风险，深度刻意受限。 - 深度分析：A 利：矿井更耐玩，长期目标多一条。弊：需要装备与难度曲线支撑，时间重量与农场主轴抢位，动摇"治愈"基调（违反 T1）。B 利：保住生活模拟纯度，战斗作为探索的节奏变化存在。弊：战斗型玩家留存偏弱——但受众映射显示目标玩家（牧场物语系）本不以战斗为主诉求。 @@ -18,7 +18,7 @@ ## 顶层期问题 ## 问题：一个游戏日怎样保持"想做的事多于做得到的"而不变成打卡负担？ -状态：user_confirmed（登记 日目标） +状态：user_confirmed（登记 D-07） - 广度分析：牵动锚点"目标体验"（掌控感与治愈的配比）、张力第 1 条（时间与体力有限）、节奏结构日内层、失败与回收档位。候选：A 收紧——每日固定目标与奖励；B 放宽——去掉每日压力；C 保留时间/体力约束，目标完全由玩家自设。 - 深度分析：A 利：方向感强。弊：把休闲变成每日打卡义务，直接命中跑偏风险第 2 条（违反 T5）。B 利：最松弛。弊：没有取舍就没有"今天的选择"，张力第 1 条落空。C 利：约束存在但重量自选；节日与季节提供低频外部节拍。弊：部分玩家需要更明确指引——可由社区修复目标与任务系统补位。 @@ -28,7 +28,7 @@ ## 架构期问题 ## 问题：采集、钓鱼与战斗要不要共享统一的"活动结果"接口？ -状态：user_confirmed（登记 活动接口） +状态：user_confirmed（登记 D-11） - 广度分析：牵动 S05/S06 的输出边界、S07 物品系统入账方式、依赖与数据流图活动侧。候选：A 三系统各自定义产出结构；B 统一"活动结果"接口（活动类型+结果列表+条件），三系统只填参数。 - 深度分析：A 利：各系统自由。弊：S07 要维护三种入账协议；任务系统验证"完成了一次采集/战斗"需分别适配——职责表里 S05/S06 的"不负责"列都指向 S07，接口不统一把适配成本堆给公共层。B 利：产出、经验、任务进度走同一条管线，S07 与 S11 只适配一次；新增活动类型不动公共层。弊：接口要预留类型差异（战利品请求/钓鱼品质），设计不当会把差异塞进自由字段。 @@ -38,10 +38,10 @@ ## 系统期问题 ## S06：战斗操作深度选哪一档？ -状态：user_confirmed（登记 战斗判定；手感部分 prototype_pending） +状态：user_confirmed（登记 D-13；手感部分 prototype_pending） - 广度分析：牵动玩家行动动词组、状态与规则的判定方式、顶层规模锚点（操作复杂度=低）、"不是什么"表第 3 行。候选：A 实时轻操作（移动+攻击+闪避）；B 节奏/指令判定（时机窗口确认）。 -- 深度分析：A 利：紧张感即时、反馈直接。弊：与顶层"操作复杂度低"直接冲突，敌人一多把轻度风险推成动作压力，动摇治愈基调（T1）。B 利：判定即反馈，压力可通过窗口宽度调节；与"伴生风险"定位相容（战斗定位）。弊：判定窗口的手感无法纸面验证——需原型。 +- 深度分析：A 利：紧张感即时、反馈直接。弊：与顶层"操作复杂度低"直接冲突，敌人一多把轻度风险推成动作压力，动摇治愈基调（T1）。B 利：判定即反馈，压力可通过窗口宽度调节；与"伴生风险"定位相容（D-03）。弊：判定窗口的手感无法纸面验证——需原型。 - 综合判断：建议 B 为设计方向：节奏/指令判定承载轻度战斗；判定窗口手感在登记表标"待原型验证"。 推翻条件：原型显示节奏判定拖慢探索节奏，或玩家反馈"按键时机莫名其妙"。 @@ -53,11 +53,11 @@ | D# | 决定 | 层 | 权威 | 依据 | 推翻条件 | 状态 | |---|---|---|---|---|---|---| -| 基调定位 | 定调：牧场物语系参照、治愈慢节奏 | 概念 | user | 用户原始需求 | — | 已确认 | -| 范围约束 | 单人体验，无多人 | 概念 | user | 概念层非目标 | — | 已确认 | -| 战斗定位 | 战斗保持伴生风险，不做装备驱动主轴 | 概念 | user | 概念期问题一 | 矿井流失率过半且归因战斗 | 已确认 | -| 日目标 | 日目标自设，季节与社区提供低频牵引 | 顶层 | user | 顶层期问题一 | 新手周流失归因无方向 | 已确认 | -| 活动接口 | 采集/钓鱼/战斗统一"活动结果"接口 | 架构 | user | 架构期问题一 | 第三活动类型出现结构性差异 | 已确认 | -| 战斗判定 | 战斗采用节奏/指令判定；窗口手感待原型 | 系统 | user | S06 问题一 | 原型显示节奏拖慢/玩家困惑 | 已确认（手感 prototype_pending） | +| D-01 | 定调：牧场物语系参照、治愈慢节奏 | 概念 | user | 用户原始需求 | — | 已确认 | +| D-02 | 单人体验，无多人 | 概念 | user | 概念层非目标 | — | 已确认 | +| D-03 | 战斗保持伴生风险，不做装备驱动主轴 | 概念 | user | 概念期问题一 | 矿井流失率过半且归因战斗 | 已确认 | +| D-07 | 日目标自设，季节与社区提供低频牵引 | 顶层 | user | 顶层期问题一 | 新手周流失归因无方向 | 已确认 | +| D-11 | 采集/钓鱼/战斗统一"活动结果"接口 | 架构 | user | 架构期问题一 | 第三活动类型出现结构性差异 | 已确认 | +| D-13 | 战斗采用节奏/指令判定；窗口手感待原型 | 系统 | user | S06 问题一 | 原型显示节奏拖慢/玩家困惑 | 已确认（手感 prototype_pending） | -（部分小权衡直接登记、未单开条目；登记编号连续且不复用。） +（D-04~D-06、D-08~D-10、D-12 为就地小权衡，直接登记未开条目；编号连续不复用。） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-art-bible.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-art-bible.md index b96c412d1..3577752f6 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-art-bible.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-art-bible.md @@ -1,4 +1,4 @@ -### C3 美术圣经模板 +### C3 02_美术圣经/模板.md（→ templates/tdd-art-bible.md） 本模板是美术实施的参考结构。按项目实际需要选择角色、场景、UI、动画和素材契约；没有对应资产类型时删除相应章节，复杂项目可增加必要的视觉规则。表格和资产条目可按实际内容扩展，不代表数量上限。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-data.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-data.md index 8654c1c39..244e8063b 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-data.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-data.md @@ -1,10 +1,10 @@ -### C3 数据与配表模板 +### C3 03_数据与配表/模板.md（→ templates/tdd-data.md） 本模板是数据与配表的参考结构。只有项目实际存在配置、枚举、关系或条件数据时才建立对应表和校验；简单项目可以直接写配置约定，复杂项目再拆分表结构与验算流程。表格中的示例行可按实际数据、字段和验算项扩展，不代表数量上限。 # 数据与配表：《游戏名》 -> 状态：{structuring / filling / accepted}　|　基于：各系统交接节汇总　|　验收记录标识：{id}；最新结论 __ +> 状态：{structuring / filling / accepted}　|　基于：各系统交接节汇总　|　验收：check@{id} 最新结论 __ ## 数据表总清单 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-master.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-master.md index e84f51b4d..1285e9f6f 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-master.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-master.md @@ -1,4 +1,4 @@ -### C3 TDD 总册模板 +### C3 模板_TDD总册.md（→ templates/tdd-master.md） 本模板是 TDD 总册的参考结构。只建立当前项目实际需要的技术、美术、数据和索引内容；没有对应方向时不创建空分册，复杂项目可以增加施工所需的分册。表格中的示例行可按实际分册、问题和验收项扩展，不代表数量上限。 @@ -48,7 +48,7 @@ | # | 来源件 | 问题 | 去向 | 状态 | |---|---|---|---|---| -| __ | 01/02/03 | __ | 决策卡 / 登记编号 / 分册修订 | __ | +| __ | 01/02/03 | __ | 决策卡 / 台账 id / 分册修订 | __ | （B 级阻断项单独置顶；本视图为临时审阅清单，结论回写各分册与台账。） diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-tech.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-tech.md index c7d8db279..166e0aa10 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-tech.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/tdd-tech.md @@ -1,4 +1,4 @@ -### C3 技术实现模板 +### C3 01_技术实现/模板.md（→ templates/tdd-tech.md） 本模板是技术实现的参考结构。按当前运行时、系统复杂度和用户要求选择章节；没有对应系统、界面、输入、音频或存档需求时，删除相应内容，复杂项目可增加施工所需章节。表格和系统条目可按实际实现范围扩展，不代表数量上限。 @@ -58,11 +58,11 @@ - 目录结构：__（承架构层目录映射：入口/场景/系统模块各在哪）。 - 命名与边界：__（文件前缀、模块间允许的调用方向）。 -## 外部依赖与可复用能力 +## 外部库与 skill 引用 | 需求 | 用什么 | 来源与版本 | 实例化参数 | |---|---|---|---| -| __ | __ | 复用能力（记录版本）/ CDN / 手写 | __ | +| __ | __ | `skill@版本` / CDN / 手写 | __ | ## 场景与镜头 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/top-design.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/top-design.md index 34e884fa5..437fcc545 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/top-design.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/templates/top-design.md @@ -1,4 +1,4 @@ -### C1 顶层设计模板 +### C1 模板_顶层设计.md（→ templates/top-design.md） 填写前按项目实际存在的循环、资源、时间层级和用户要求筛选本模板的章节；同类内容可合并，复杂项目可增加必要内容。表格、列表和循环示例按实际内容扩展。 diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/system-prompt.md b/apps/ai-game-creator-shell/src-tauri/design-agent/system-prompt.md index a701357cf..deb3a18c0 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/system-prompt.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/system-prompt.md @@ -13,6 +13,6 @@ 阶段获批后，产物中已经采用的方案作为后续工作的依据，并保留原有决策来源。用户主动质疑或出现新的约束冲突时，再重新讨论相关决定。 -用户说“继续”时，继续推进当前阶段最有价值的工作。在五个策划阶段中，判断本阶段已完成并准备交用户检阅时，应调用 `submit_phase_for_approval` 正式提交审批。 +用户说“继续”时，继续推进当前阶段最有价值的工作。在五个策划阶段中，判断本阶段已完成并准备交用户检阅时，应调用 `submit_phase_for_approval`；只有该工具调用成功，才算正式提交审批。 用户口头表示已经批准或要求进入下一阶段时，先调用 `get_workflow_status` 确认当前阶段；只有该阶段已批准，才进入下一阶段，不得自行推进阶段。