From c95ed2b519b53c1fc5a8efc1f53febefa5d33dc2 Mon Sep 17 00:00:00 2001 From: Linghong Date: Mon, 28 Sep 2026 03:58:46 +0000 Subject: [PATCH] =?UTF-8?q?=E7=AE=80=E5=8C=96=E6=95=B0=E6=8D=AE=E5=88=86?= =?UTF-8?q?=E5=86=8C=E7=BB=93=E6=9E=84=E5=B9=B6=E9=81=BF=E5=85=8D=E9=85=8D?= =?UTF-8?q?=E7=BD=AE=E4=B8=8E=E6=96=87=E6=A1=88=E9=87=8D=E5=A4=8D=E5=88=97?= =?UTF-8?q?=E5=80=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 合并数据模板的字段说明与完整内容章节，简单配置和文案集中维护。 同步写作规则与星露谷样例，保留多记录字段定义及完整配置、文案和验算要求。 更新策划技术方案与共享决策记录。 --- .../resources/exemplars/stardew-tdd-data.md | 5 ++-- .../resources/exemplars/tdd-data-SKILL.md | 2 ++ .../resources/templates/tdd-data.md | 26 ++++++++----------- .../shared-memory/decision-log.md | 5 ++++ ...】策划Agent生产迁移与工作区浏览-2026-09-10.md | 2 ++ 5 files changed, 22 insertions(+), 18 deletions(-) diff --git a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-data.md b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-data.md index 55527f085..0aa11c89b 100644 --- a/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-data.md +++ b/apps/ai-game-creator-shell/src-tauri/design-agent/resources/exemplars/stardew-tdd-data.md @@ -19,16 +19,15 @@ ## 已知字段契约与示例配置 -下表只覆盖已出现的字段。ID 是不随显示名称变化的字符串；引用不存在时不能把动作算作成功。数值单位写在字段定义中，不能把游戏日、体力、金钱和经验混用。无默认值的字段必须显式给值；本例没有授权用 `0`、空值或估值替代缺失配置。 +本例涉及物品、作物等记录，因此将共用字段定义与具体记录分列；具体取值只在记录中定义，验算场景输入放在验算段落。少量配置可合写字段含义与当前值，无需照搬两张表。下表只覆盖已出现的字段。ID 是不随显示名称变化的字符串；引用不存在时不能把动作算作成功。数值单位写在字段定义中，不能把游戏日、体力、金钱和经验混用。无默认值的字段必须显式给值；本例没有授权用 `0`、空值或估值替代缺失配置。 | 字段及维护者 | 类型与单位 | 本例约束/默认值 | 消费方式 | |---|---|---|---| | S07 `item_id` | 非空字符串 | 必填、唯一；无默认值 | S03、S05、S09 以 ID 引用物品 | | S03 `crop_id`、`seed_item_id`、`harvest_item_id` | 非空字符串 | 必填、唯一作物 ID；两个物品引用无默认值 | 播种消费种子；收获请求产出物品入账 | -| S03 `growth_days` | 非负整数，游戏日 | 必填；本例 4；无默认值 | 每次满足成长条件的跨日推进一次 | +| S03 `growth_days` | 非负整数，游戏日 | 必填；无默认值 | 每次满足成长条件的跨日推进一次 | | S09 `buy_price`、`sell_price`、`starting_currency` | 非负整数，金 | 必填；无默认值 | 买入扣款、出售入账、开局钱包 | | S08 `farming_xp_per_harvest`、`farming_level_1_xp` | 非负整数，经验 | 必填；无默认值 | 成功收获入账并比较等级阈值 | -| 验算 `seed_count` | 非负整数，包 | 仅场景输入，本例 15；不是商店库存默认值 | 验算一次购买和播种的总量 | | 维护系统 | 示例记录或参数 | 已知值与引用 | 仍缺的当前范围配置 | |---|---|---|---| 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 70f22d16d..51847ed1f 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 @@ -12,6 +12,8 @@ ## 写出可直接消费的配置 +按数据形态选择组织方式：少量配置把名称、当前值、单位或含义及必要约束合写，不再重复列配置清单；同结构多条记录可分为共用字段定义和完整记录。玩家可见文案集中列一次，注明使用位置；其他章节引用已有定义，不重复抄录。共用消费方式集中说明，特殊用法就近注明，不为每个简单常量另建消费映射表；派生值说明计算关系，不作为另一份配置登记。 + 对当前范围每个数据集，写明维护系统、记录身份、字段类型、单位、允许值、默认值或必填要求、引用目标和消费方。默认值只给确实允许省略的字段；未确定的关键值列入待解决问题，不能把“待定”当成运行值。多值采用能明确表达数量和顺序的结构，按实际消费需要选择数组、对象或独立表。 把当前范围所需的**全部**记录和玩家可见文案放入本套 TDD，或明确指向本套 TDD 内唯一的权威定义。示例行不能代替完整配表；不能用“照此补齐”掩盖作物、商品、资源点或提示文案的缺口。对每条跨系统引用，说明来源、目标以及使用方如何处理缺失、不可用或入账失败。改变数据时同步更新受影响的规则、配置和验算。 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 09963e939..cfd37deea 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 @@ -10,27 +10,23 @@ 只列本期实际使用的内容。每项事实只在一个位置定义；其他系统引用其 ID 或读取其结果。复杂项目可按需要拆为多张表、JSON 或工作簿，简单项目可在本册直接列清。 -## 字段与消费契约 +## 数据定义与完整内容 -对每个实际数据集列出记录身份、全部字段、类型、单位、允许值、默认值或必填要求、引用目标。下表按需复制；不要求所有数据集拥有相同字段。 +根据实际数据形态组织，字段说明与具体取值可以合并。少量配置可直接使用下表，不另设重复的配置清单；同结构多条记录可分别给出共用字段定义和完整记录，不要求两种形式都使用。 -### __（维护系统：__） +| 参数或适用对象 | 当前值 | 单位、含义与必要约束 | +|---|---|---| +| __ | __ | __ | -| 字段 | 类型及单位 | 必填或默认值 | 允许值/约束 | 引用目标与消费方式 | -|---|---|---|---|---| -| __ | __ | __ | __ | __ | +写清实际需要的记录身份、字段类型、单位、允许值、默认值或必填要求、归属及引用。共用消费方式集中说明，特殊用法就近注明，不为每个简单常量另建消费映射表。派生值写明计算关系，不作为另一份配置重复登记。实例状态与静态配置、读取时机、缺失或失败处理在影响实现时说明；一对多内容采用能明确表达数量和顺序的结构，条件、随机或迁移数据只在实际需要时定义。 -说明：__（如实例状态与静态配置的区别、数据何时读取、缺失或失败如何处理）。若存在一对多内容，选用能清楚表示数量与顺序的结构；条件、随机或迁移数据只在实际需要时定义。 +玩家可见文案集中列一次，注明使用位置： -## 当前范围完整配置与文案 +| 文案标识 | 完整文本 | 使用位置及必要说明 | +|---|---|---| +| __ | __ | __ | -在此列出当前实现范围**每一条**实际记录和值，包括所需的系统参数、配置和玩家可见文案；也可明确指向本套 TDD 中唯一的权威定义。下面的单行仅示范格式，不表示填充完成。 - -| 数据集 | ID 或适用对象 | 字段和值（含单位） | 来源/引用 | -|---|---|---|---| -| __ | __ | __ | __ | - -内容数量由已定范围决定。允许明确当前采用的初值并在原型中调优；未定关键值进入“待解决问题”，不可用空白、未经说明的估值或几行示例冒充完整配置。 +当前范围所需的**全部**实际记录、参数值和文案必须在本套 TDD 中完整给出。已在本套 TDD 其他位置定义的内容，明确引用其唯一权威位置，不重复抄录；上面的占位行不代表填充完成。内容数量由已定范围决定，允许明确当前采用的初值并在原型中调优；未定关键值进入“待解决问题”，不可用空白、未经说明的估值或几行示例冒充完整配置。 ## 关键循环验算 diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index e0e4bf978..6ce712888 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -1,5 +1,10 @@ # 决策记录 +## 2026-09-28 数据分册按数据形态组织，避免重复列值 + +- 少量配置合写字段含义与当前值，同结构多条记录可分列共用字段定义和完整记录；文案集中列一次，其他位置引用唯一权威定义，共用消费方式集中说明，派生值只保留计算关系。 +- 数据模板、写作规则及样例采用同一口径，当前范围完整配置、文案与验算要求不变。当前合同见[策划 Agent 生产迁移方案第 6 节](../../technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md#6-阶段与提示词注入)。 + ## 2026-09-28 策划文档密度按项目需求与复杂度安排 - 常驻提示词统一要求按项目需求、规模和复杂度组织内容；模板与样例仅供参考，章节和字段按需增减、合并，简单内容简述，复杂或易歧义处充分展开，不为填模板增加设计或重复论证。 diff --git a/docs/technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md b/docs/technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md index 1886c8420..a8a2860f4 100644 --- a/docs/technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md +++ b/docs/technical/【技术方案】策划Agent生产迁移与工作区浏览-2026-09-10.md @@ -318,6 +318,8 @@ TDD 按实际内容组织，可重组 GDD 规则而不要求逐段全文复制 总册保留当前范围、分册索引、来源版本、实际跨分册约定与重要缺口，不重复生产验收表或以 frozen 标签判定通过。`project/04_tdd/01_技术实现.md`、`02_美术圣经.md`、`03_数据与配表.md`、`总册.md` 四个产物继续保留，不涉及的方向在分册简述原因。十二份 TDD 规则、模板和样例同步这一口径；星露谷样例聚焦首个日常原型，数值与素材规格标明示例假设，未附证据的原作实证、构建通过和资产验收声明清理，规格与验算缺口如实保留。资源 ID、路径、阶段注入及 Runtime 的文件存在性检查不变。 +数据模板将字段说明与完整内容合为一节：少量配置合写含义与当前值，同结构多条记录可分列共用字段定义和完整记录；文案集中列一次，其他位置引用唯一权威定义。共用消费方式集中说明，派生值保留计算关系，不重复登记配置或为简单常量另建映射表。写作规则与样例同步这一组织方式，当前范围完整配置、文案和验算要求保持不变。 + 写作规则由 `system-prompt.md`、`phase-context/`、资源目录登记的 `skills/` 与各分册承接；重复且过期的 `resources/SKILL.md` 合并总稿已删除，历史由 Git 保留。 顶层设计将概念展开为游玩过程、关键规则与反馈、资源与进展、选择后果、版本范围及验证计划。规则、模板和样例按实际玩法组织，不强制三层循环、三种互相供给的回报、资源“来源—储存—消耗”链、日历节奏、反馈层数、唯一原型片段或失败三选一；最优解是否成立取决于玩法，必要的规则与参数可以在顶层明确。保留核心定位及按需说明的易混淆方向与排除理由，不强制固定句式或结尾重复定稿。