starmen1265/ChildHood
1
0
Fork 0
Code Issues 11 Pull Requests Actions Packages Projects 2 Releases Wiki Activity

refactor(skills): Agent架构重构——去阶段/去步骤号/审查纯Issue化/工作流拆技能/目录扁平化

Browse Source 
- game-reviewer: 删除本地审查记录，仅Issue评论
- quality-gate-review: 删除审查记录/步骤号/阶段标准
- game-dev: 删除阶段感知节，4个工作流详情拆到技能
- game-designer: 删除原型/批量生产阶段，执行案规范拆到技能
- game-pm: 去掉节号和步骤号
- 全局去掉步骤标号（①-⑧/步骤1-5/1.4.X/第一步-第四步）
- 新建技能: code-implementation/deviation-report/design-execution
- 原型目录扁平化: docs/design/prototype/* → docs/design/
- requirements-analysis及子文件去步骤号和阶段引用
- stage-iteration/sketch/roadmap去任务编号
- 更新所有docs/design/路径引用
This commit is contained in:
starmen1265
2026-06-08 16:03:24 +08:00
parent 53a8dc9fed
commit c3c10a9fcb
44 changed files with 435 additions and 508 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude/skills/requirements-analysis/SKILL.md
+16 -18
View File
@@ -10,19 +10,19 @@ description: >
# 需求分析 Skill
8 步结构化需求分析工作流，从执行文档（执行案）到技术设计文档。为 UE5 游戏系统的程序设计（步骤④）提供系统化的分析方法论。
8 步结构化需求分析工作流，从执行文档（执行案）到技术设计文档。为 UE5 游戏系统的程序设计提供系统化的分析方法论。
## 触发条件
- **步骤④自动触发**：game-dev agent 进入程序设计阶段时自动使用此 skill
- **程序设计阶段自动触发**：game-dev agent 进入程序设计时自动使用此 skill
- **用户手动触发**：用户说"做需求分析"、"设计技术方案"、"写技术设计文档"等时触发
## 输入
按序阅读以下文档，获取完整的上下文信息：
1. **执行文档** (`docs/design/<stage>/<系统名>-执行案.md`) — 行为规则细节（主要输入）
2. **系统设计文档** (`docs/design/<stage>/<系统名>.md`) — 全局上下文
1. **执行文档** (`docs/design/<系统名>-执行案.md`) — 行为规则细节（主要输入）
2. **系统设计文档** (`docs/design/<系统名>.md`) — 全局上下文
3. **配置表** (`GameConfig/`) — 可调参数
4. **概念文档** (`docs/design/概念草案.md`) — 方向参考（需要理解设计意图时查阅）
@@ -30,7 +30,7 @@ description: >
## 8 步分析工作流
### 步骤①：需求功能点罗列
### 需求功能点罗列
从执行文档中提取每个行为规则作为功能点，按实现方式分为两大类：
@@ -51,7 +51,7 @@ description: >
以表格形式输出，每个功能点标注对应的执行案条目编号。分类原则：UE 内置能力覆盖 80% 以上需求且行为一致 → UE 内置；否则 → 自定义实现。
### 步骤②：功能领域图
### 功能领域图
识别当前系统由哪些功能模块组成，以及模块之间的交互关系。
@@ -63,7 +63,7 @@ description: >
- 虚线 `-.->` 表示事件通知 / 异步通信
- 配合模块职责说明表格
### 步骤③：类设计图
### 类设计图
将功能领域图细化为具体的类设计。展示每个类的关键数据成员和关键接口，以及类之间的关系。
@@ -79,7 +79,7 @@ description: >
同时提供新增类表格、修改类表格、新增蓝图表格。类命名遵循 UE5 前缀规范（`A`/`U`/`I`/`F`/`E`）。
### 步骤④：时序图（条件性）
### 时序图（条件性）
> ⚠️ 仅当特性满足以下任一条件时绘制：涉及 3+ 个系统协调、有条件分支或循环流程、跨层级通信（UI ↔ 逻辑 ↔ 数据）。简单特性跳过。
@@ -90,7 +90,7 @@ description: >
- 使用 `activate`/`deactivate` 展示调用栈深度
- 标注关键判断分支
### 步骤⑤：核心数据结构
### 核心数据结构
定义系统所需的枚举、结构体、配置数据。
@@ -101,7 +101,7 @@ description: >
- 每个字段提供中文注释说明和合理的默认值
- 区分"配置参数"和"运行时状态"
### 步骤⑥：复杂接口描述（条件性）
### 复杂接口描述（条件性）
> ⚠️ 仅当接口有 5+ 个决策分支或协调多个子系统状态时需要。简单接口（纯数据查询、简单赋值）跳过。
@@ -112,7 +112,7 @@ description: >
描述时必须包含：前置检查（快速失败）→ 核心逻辑 → 异步操作标注 → 边界情况处理。
### 步骤⑦：技术难点/风险
### 技术难点/风险
识别并评估实现过程中可能遇到的技术难点和风险：
@@ -120,7 +120,7 @@ description: >
- 每个风险包含：风险描述、详细说明、缓解措施
- 特别关注：UE5 限制、性能瓶颈、跨系统时序问题、数据一致性
### 步骤⑧：工期预估
### 工期预估
给出工作量和实现拆分建议：
@@ -138,9 +138,7 @@ description: >
文档必须遵循 `references/output-template.md` 中定义的标准模板结构。8 步分析的结果整合到模板的对应章节中，同时保留现有的必要章节（美术资源需求、数据流、可调参数汇总、文件结构）。
**阶段适配**：
- 原型阶段：步骤②④⑥可适度简化，允许占位描述
- 批量生产阶段：所有步骤必须完整、详细
**简化规则**：时序图和复杂接口描述可根据复杂度判定跳过（见条件步骤判定速查）。
---
@@ -148,8 +146,8 @@ description: >
| 步骤 | 激活条件 | 跳过条件 |
|------|---------|---------|
| ④ 时序图 | 3+ 系统协调 / 有分支循环 / 跨层级通信 | 单系统内部 / 纯配置 |
| ⑥ 复杂接口描述 | 5+ 决策分支 / 协调多子系统 / 有异步等待 | 简单查询 / 2-4 分支简单逻辑 |
| 时序图 | 3+ 系统协调 / 有分支循环 / 跨层级通信 | 单系统内部 / 纯配置 |
| 复杂接口描述 | 5+ 决策分支 / 协调多子系统 / 有异步等待 | 简单查询 / 2-4 分支简单逻辑 |
详细判定启发式参见 `references/diagram-guide.md` 第 3 节。
@@ -161,4 +159,4 @@ description: >
|------|------|---------|
| `references/diagram-guide.md` | Mermaid 语法速查、项目约定、复杂度判定 | 绘制任何图表前查阅 |
| `references/output-template.md` | 完整技术设计文档模板 | 开始写文档前查阅，确保结构完整 |
| `references/examples.md` | 各步骤的注释示例（来自现有技术文档） | 需要参考输出效果时查阅 |
| `references/examples.md` | 需求分析的注释示例（来自现有技术文档） | 需要参考输出效果时查阅 |
.claude/skills/requirements-analysis/references/diagram-guide.md
+6 -6
View File
@@ -6,7 +6,7 @@
## 1. Mermaid 语法速查
### 1.1 功能领域图（步骤②）
### 1.1 功能领域图
使用 `flowchart` 展示功能模块及其交互关系。模块级抽象，不涉及类级别细节。
@@ -57,7 +57,7 @@ flowchart TD
---
### 1.2 类设计图（步骤③）
### 1.2 类设计图
使用 `classDiagram` 展示类的关键数据、接口和关系。
@@ -131,7 +131,7 @@ classDiagram
---
### 1.3 时序图（步骤④）
### 1.3 时序图
使用 `sequenceDiagram` 追踪复杂特性的跨系统调用流程。
@@ -188,7 +188,7 @@ sequenceDiagram
---
### 1.4 流程图 / 鲁棒图（步骤⑥）
### 1.4 流程图 / 鲁棒图
使用 `flowchart` 描述复杂接口的决策分支和执行流程。
@@ -254,7 +254,7 @@ flowchart TD
## 3. 复杂度判定启发式
### 3.1 何时需要时序图（步骤④）
### 3.1 何时需要时序图
时序图为条件性步骤，仅在特性满足以下任一条件时需要绘制：
@@ -266,7 +266,7 @@ flowchart TD
| 仅涉及单系统内部配置 | 不需要 | SpringArm 参数调整（纯配置） |
| 仅 2 个系统简单调用 | 可选 | Character 设置 flag → Movement 检查 flag |
### 3.2 何时需要复杂接口描述（步骤⑥）
### 3.2 何时需要复杂接口描述
复杂接口描述为条件性步骤，仅在接口满足以下任一条件时需要：
.claude/skills/requirements-analysis/references/examples.md
+1 -1
View File
@@ -1,4 +1,4 @@
# 需求分析各步骤示例
# 需求分析示例
本文档从项目现有技术设计文档中提取注释示例，展示每步分析的实际输出效果。
.claude/skills/requirements-analysis/references/output-template.md
+5 -6
View File
@@ -7,12 +7,11 @@
## 模板
```markdown
# <系统名称> 技术设计文档（<版本号> <阶段>）
# <系统名称> 技术设计文档（<版本号>）
> 任务ID: <任务编号>
> 对应执行案: `docs/design/<stage>/<系统名>-执行案.md`
> 对应执行案: `docs/design/<系统名>-执行案.md`
> 关联系统: <上游/下游/平行系统列表>
> 阶段: 原型 / 批量生产 / 测试
> 日期: <YYYY-MM-DD>
---
@@ -245,7 +244,7 @@ function <InterfaceName>(<params>):
|----------|------|------|------|---------------|
| <3D模型/动画/UI/2D图标/音效> | <名称> | <数量> | <尺寸/格式/时长> | <何时使用> |
> v0.1 原型阶段允许占位资源，但类型和数量必须明确。
> 类型和数量必须明确，允许占位资源。
---
@@ -319,7 +318,7 @@ Content/
### 实现拆分建议
供步骤⑥（程序实现）参考的推荐拆分方式，每个子任务可独立验证：
供程序实现参考的推荐拆分方式，每个子任务可独立验证：
| 子任务 | 内容 | 预估时间 | 依赖 | 验证方式 |
|--------|------|---------|------|---------|
@@ -334,4 +333,4 @@ Content/
2. **条件性章节**（第 4 节时序图、第 6 节复杂接口描述）：根据复杂度判定决定是否包含
3. **Mermaid 图表**：在 markdown 渲染器中会自动生成可视化图表
4. **保持一一映射**：每条执行文档行为规则都必须在第 6 节有对应实现方案
5. **阶段适配**：原型阶段允许简化描述，批量生产阶段需要完整覆盖所有章节
5. **完整覆盖**：所有章节需按模板结构填写，条件性章节按复杂度判定