统一简化策划文档维护与技术决策登记
Project CI / AI game creator shell Rust crates (pull_request) Successful in 1m31s
Project CI / AI game creator shell Rust smoke (pull_request) Successful in 1m58s
Project CI / Backend tests (pull_request) Successful in 3m58s
Project CI / Frontend tests (pull_request) Successful in 2m11s
Project CI / Native shell tests (pull_request) Successful in 6m2s
Project CI / AI game creator shell web tests (pull_request) Successful in 1m31s
Project CI / Repository checks (pull_request) Successful in 2m0s
Project CI / AI game creator shell Rust lane 2/2 (pull_request) Successful in 9m40s
Project CI / AI game creator shell Rust lane 1/2 (pull_request) Successful in 10m17s
Project CI / AI game creator shell Rust crates (pull_request) Successful in 1m31s
Project CI / AI game creator shell Rust smoke (pull_request) Successful in 1m58s
Project CI / Backend tests (pull_request) Successful in 3m58s
Project CI / Frontend tests (pull_request) Successful in 2m11s
Project CI / Native shell tests (pull_request) Successful in 6m2s
Project CI / AI game creator shell web tests (pull_request) Successful in 1m31s
Project CI / Repository checks (pull_request) Successful in 2m0s
Project CI / AI game creator shell Rust lane 2/2 (pull_request) Successful in 9m40s
Project CI / AI game creator shell Rust lane 1/2 (pull_request) Successful in 10m17s
简化分析文档、决策台账、对话记录与速览卡的维护要求 清理阶段分册、模板和样例中的重复登记协议 简化技术决策记录,保留只凭TDD完成当前范围实现的要求 修正未决问题与施工完备性矛盾的样例并同步项目文档
This commit is contained in:
@@ -289,7 +289,24 @@ concept → top_design → architecture → systems → tdd → consultant
|
||||
|
||||
这些路径直接服务于 Agent 的文件操作和资源查阅,属于提示词应保留的契约;即使阶段上下文也注入了某条产物路径,分册和模板中的路径仍提供目标文件与交叉引用的具体定位。去除客户端与宿主实现细节时,不应把这类相对路径当作意外暴露的内部实现;宿主安装目录、项目绝对路径及会话控制文件位置才不属于 Agent 的操作输入。
|
||||
|
||||
过程文档记录关键依据、决定和待办,不要求实时完整,也不应重复正式设计文档;阶段提交前补齐影响验收的关键记录。顶层设计的分册、模板和示例保留核心定位及按需说明的易混淆方向与排除理由,不强制使用固定的“不是 X,而是 Y”句式。
|
||||
共享文档按以下职责维护,文件路径和审批必需产物清单保持不变:
|
||||
|
||||
| 文档 | 用途与更新时机 |
|
||||
| --- | --- |
|
||||
| `project/analysis.md` | 按需保留重要取舍的依据与当前结论;存在实际备选时再比较,未决问题说明原因或下一步。结论稳定或依据变化时更新,可合并修订条目,不记录每次讨论。 |
|
||||
| `project/决策台账.md` | 按需集中列出待处理事项和下一步,必要时引用分析或正式设计。事项变化时更新,完成后移出待办,不再重复保存全部已采用决定。 |
|
||||
| `project/dialog.md` | 仅在用户需要对话摘要或交接记录时维护,不逐轮转录聊天。 |
|
||||
| `project/速览卡.md` | 概念阶段形成游戏概览;后续仅在核心体验、范围、平台等摘要内容变化时更新,不复制完整决策清单。 |
|
||||
|
||||
正式设计承载当前采用的规则,共享文档按各自用途记录,不要求同一决定在多处重复登记。不强制连续编号、状态枚举、候选数、问题数量、推翻条件或完整历史流水;尚未确定的事项用自然语言说明,不冒充用户确认。阶段提交前检查影响交付的信息是否一致,不以补齐过程记录作为新门禁。已有项目文件不批量重写或删除。
|
||||
|
||||
TDD 的决策记录采用相同原则:施工规格、参数、默认值直接写入对应分册,重要取舍按需保留分析,未决事项说明影响与下一步,不要求逐项登记到外部台账或附推翻条件。总册保留施工索引、跨分册契约与重要缺口,详细问题指向对应分册。问题解决后更新受影响的 GDD 与 TDD 正文并关闭待办,不能只登记处理去向。
|
||||
|
||||
“施工方只看 TDD,应能完成当前范围的实现”仍是完成标准。保留 GDD 内容收编、来源版本与变更同步,以及资产清单、字段字典、接口规格、验收记录等施工信息;外部分析与台账不能代替 TDD 的实现说明。当前范围仍有影响实现的关键问题时,不得宣称该范围已完备。样例中尚有缺口的 TDD 应如实展示未完成状态,不以已登记或部分检查通过代替规格完整。
|
||||
|
||||
`resources/SKILL.md` 未登记到资源目录,不属于现役注入来源。
|
||||
|
||||
顶层设计的分册、模板和示例保留核心定位及按需说明的易混淆方向与排除理由,不强制使用固定的“不是 X,而是 Y”句式。
|
||||
|
||||
进入下一阶段必须由用户批准触发。Runtime 推进后向 Agent 追加明确的用户行为语义,例如“用户已批准上一阶段,现在进入顶层设计阶段”,避免 Agent 误认为 Runtime 自行推进。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user