feat(tools): 白模关卡自动生成Python脚本——Level Builder
两阶段流水线：搭建指南Markdown → JSON → UE5 Actor - 解析器：4种表格变体+范围展开+坐标表达式计算 - 配置：37种BSP资产映射+13种材质+7区域定义 - 验证：265个Actor全部通过，0错误 - Builder：UE5 Python API自动放置Actor+材质+Outliner - 报告：自动生成搭建报告Markdown Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -75,7 +75,7 @@ description: "Gitea 协作工具 — CLI 命令速查、认证机制、Assignee
|
||||
| `gate:impl-pass` | 程序实现验收门通过 |
|
||||
| `gate:impl-fail` | 程序实现验收门未通过 |
|
||||
|
||||
> **注**：旧 Issue 上可能仍有 `pipeline:*` 和 `role:*` 标签，这些已不再使用，保留不管即可。
|
||||
> **注**：`pipeline:*` 和 `role:*` 标签已废弃并从 Gitea 上删除。如旧 Issue 上仍残留这些标签，忽略即可。
|
||||
|
||||
---
|
||||
|
||||
@@ -178,7 +178,7 @@ node scripts/gitea.js test
|
||||
| 角色归属 | Assignee | 通过 `--assignees` 指派 |
|
||||
| 流水线步骤 | Pipeline Tracker | Meta Issue 记录全局流水线状态 |
|
||||
| 角色汇报 | Issue 评论 | 各角色在对应 Issue 下评论 |
|
||||
| 审查记录 | Issue 评论（摘要+链接）+ 本地 `docs/plans/reviews/` | 本地保留详细结构化文档 |
|
||||
| 审查记录 | Issue 评论（摘要+链接）+ 本地 `docs/plans/reviews/` | 本地文件名格式 `<任务ID>-审查记录.md` |
|
||||
| 任务归档 | close Issue | 不需要本地 archive 文件 |
|
||||
|
||||
---
|
||||
@@ -266,7 +266,7 @@ node scripts/gitea.js --role pm issue comment <number> --body "## 质量门审
|
||||
|
||||
**质量门**：[类型]
|
||||
**审查日期**：YYYY-MM-DD
|
||||
**审查记录**：docs/plans/reviews/<task-ID>-review.md
|
||||
**审查记录**：docs/plans/reviews/<task-ID>-审查记录.md
|
||||
|
||||
### 结论
|
||||
[一句话总结]
|
||||
@@ -282,7 +282,7 @@ node scripts/gitea.js --role pm issue close <number> --body "## 任务完成 ✔
|
||||
|
||||
**完成日期**：YYYY-MM-DD
|
||||
**产出**：path/to/output
|
||||
**审查记录**：docs/plans/reviews/<task-ID>-review.md"
|
||||
**审查记录**：docs/plans/reviews/<task-ID>-审查记录.md"
|
||||
```
|
||||
|
||||
---
|
||||
@@ -315,7 +315,7 @@ node scripts/gitea.js --role pm issue comments <number>
|
||||
# 创建 Issue（必须指定 assignees）
|
||||
node scripts/gitea.js --role pm issue create \
|
||||
--title "D-001 交互系统执行案" \
|
||||
--body "## 任务信息\n- **任务ID**: D-001\n- **所属版本**: v0.1\n- **角色**: 策划\n- **预期产出**: docs/design/prototype/interaction-system-execution.md\n..." \
|
||||
--body "## 任务信息\n- **任务ID**: D-001\n- **所属版本**: v0.1\n- **角色**: 策划\n- **预期产出**: docs/design/prototype/交互系统-执行案.md\n..." \
|
||||
--milestone <id> \
|
||||
--assignees ai-designer
|
||||
|
||||
|
||||
@@ -24,7 +24,7 @@ description: "质量门审查技能 — 4 道质量门标准、阶段对应标
|
||||
- 根据当前开发阶段选择对应标准（原型 vs 批量生产，见"阶段对应标准"）
|
||||
|
||||
### 3. 写审查记录（本地文件）
|
||||
- 路径：`docs/plans/reviews/<task-ID>-review.md`
|
||||
- 路径：`docs/plans/reviews/<task-ID>-审查记录.md`
|
||||
- 格式见下方"审查记录格式"
|
||||
|
||||
### 4. Issue 评论（强制）
|
||||
@@ -117,7 +117,7 @@ description: "质量门审查技能 — 4 道质量门标准、阶段对应标
|
||||
|
||||
## 审查记录格式
|
||||
|
||||
文件路径：`docs/plans/reviews/<task-ID>-review.md`
|
||||
文件路径：`docs/plans/reviews/<task-ID>-审查记录.md`
|
||||
|
||||
```markdown
|
||||
# [任务 ID] 审查报告
|
||||
@@ -148,7 +148,7 @@ description: "质量门审查技能 — 4 道质量门标准、阶段对应标
|
||||
|
||||
审查完成后，**必须**逐项确认以下操作：
|
||||
|
||||
- [ ] 在 `docs/plans/reviews/<task-ID>-review.md` 写了审查记录
|
||||
- [ ] 在 `docs/plans/reviews/<task-ID>-审查记录.md` 写了审查记录
|
||||
- [ ] 在对应 Issue 上发布了审查结论评论（通过/不通过 + 摘要）
|
||||
- [ ] 更新了 Issue 的 gate:* 标签（通过→pass，不通过→fail）
|
||||
- [ ] **通过时**：关闭 Issue 并附完成说明
|
||||
|
||||
@@ -21,10 +21,10 @@ description: >
|
||||
|
||||
按序阅读以下文档，获取完整的上下文信息：
|
||||
|
||||
1. **执行文档** (`docs/design/<stage>/<system-name>-execution.md`) — 行为规则细节（主要输入）
|
||||
2. **系统设计文档** (`docs/design/<stage>/<system-name>.md`) — 全局上下文
|
||||
1. **执行文档** (`docs/design/<stage>/<系统名>-执行案.md`) — 行为规则细节（主要输入）
|
||||
2. **系统设计文档** (`docs/design/<stage>/<系统名>.md`) — 全局上下文
|
||||
3. **配置表** (`GameConfig/`) — 可调参数
|
||||
4. **概念文档** (`docs/design/concept.md`) — 方向参考（需要理解设计意图时查阅）
|
||||
4. **概念文档** (`docs/design/概念草案.md`) — 方向参考（需要理解设计意图时查阅）
|
||||
|
||||
---
|
||||
|
||||
@@ -134,7 +134,7 @@ description: >
|
||||
|
||||
## 输出
|
||||
|
||||
最终产出为技术设计文档，保存到 `docs/technical/<system-name>-tech.md`。
|
||||
最终产出为技术设计文档，保存到 `docs/technical/<系统名>-技术方案.md`。
|
||||
|
||||
文档必须遵循 `references/output-template.md` 中定义的标准模板结构。8 步分析的结果整合到模板的对应章节中，同时保留现有的必要章节（美术资源需求、数据流、可调参数汇总、文件结构）。
|
||||
|
||||
|
||||
@@ -280,11 +280,11 @@ flowchart TD
|
||||
|
||||
### 3.3 项目实际案例参考
|
||||
|
||||
**需要时序图的特性**（从现有 `interaction-system-tech.md` 提取）：
|
||||
**需要时序图的特性**（从现有 `交互系统-技术方案.md` 提取）：
|
||||
- 完整交互流程（Enter → AnimLock → Active → Exit）
|
||||
- 拾取流程（交互系统 → 物品系统 → 收集系统）
|
||||
|
||||
**不需要时序图的特性**（从现有 `player-controller-tech.md` 提取）：
|
||||
**不需要时序图的特性**（从现有 `玩家控制器-技术方案.md` 提取）：
|
||||
- SpringArm 参数配置（纯构造函数设置）
|
||||
- CMC 移动参数调整（纯配置）
|
||||
|
||||
|
||||
@@ -8,9 +8,9 @@
|
||||
|
||||
| 示例 | 来源文档 |
|
||||
|------|---------|
|
||||
| 交互系统 | `docs/technical/interaction-system-tech.md` |
|
||||
| 角色控制 | `docs/technical/player-controller-tech.md` |
|
||||
| 收集系统 | `docs/technical/collection-system-tech.md` |
|
||||
| 交互系统 | `docs/technical/交互系统-技术方案.md` |
|
||||
| 角色控制 | `docs/technical/玩家控制器-技术方案.md` |
|
||||
| 收集系统 | `docs/technical/收集系统-技术方案.md` |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
# <系统名称> 技术设计文档（<版本号> <阶段>）
|
||||
|
||||
> 任务ID: <任务编号>
|
||||
> 对应执行案: `<执行案文件路径>`
|
||||
> 对应执行案: `docs/design/<stage>/<系统名>-执行案.md`
|
||||
> 关联系统: <上游/下游/平行系统列表>
|
||||
> 阶段: 原型 / 批量生产 / 测试
|
||||
> 日期: <YYYY-MM-DD>
|
||||
|
||||
Reference in New Issue
Block a user