---
name: aibridge-development-workflow
description: "AIBridge/Unity 项目的标准开发工作流。Use when creating, modifying, fixing, refactoring, or validating C# code, Unity assets, prefabs, editor tools, package structure, tests, AGENTS.md, or local Skills. Preserves visible modes for Skills matching, requirement confirmation, analysis, implementation, and final checklist. Do not use for pure Q&A, simple search/display, or code explanation tasks with no file/code/asset changes."
---

# AIBridge Development Workflow

## 目标

在开发任务中保留清晰的阶段可视化，让用户知道当前 AI 正处于哪个工作阶段、加载了哪些 Skills，并在结束前执行明确的验收清单。

本 Skill 只放主流程。细节规则按需读取：

- `references/risk-gates.md`：需求确认、风险分级、何时必须暂停确认。
- `references/coding-rules.md`：C#、Unity、注释、硬编码、重复代码规则。
- `references/checklist.md`：最终检查清单和收尾输出格式。

## 阶段总览

开发任务按以下模式推进：

`【Skills 匹配模式】 → 【需求确认模式】 → 【分析模式】 → 【方案实施模式】 → 【检查清单模式】`

简单低风险修改可以在一条回复中连续展示多个模式，但不能省略分析和最终检查清单。

## Skills 匹配模式

收到开发任务后，先输出实际使用的 Skills，仅列名称：

```text
【Skills 匹配模式】aibridge-development-workflow、aibridge
```

匹配规则：

- 所有开发任务至少包含 `aibridge-development-workflow`。
- 涉及 AIBridge CLI、Unity 编译、日志、代码文件查找、资源搜索、预制、场景或 Inspector 操作时，加入 `aibridge`。
- 涉及复杂 Prefab 资源修改、批量 SerializedProperty、子物体/组件创建或引用写入时，加入 `aibridge-prefab-patch`。
- 涉及 batch、multi、批处理脚本、长脚本、stdin 或脚本自动化时，加入 `aibridge-batch-script`。
- 涉及创建或修改 Skill 时，加入 `skill-creator`。

## 需求确认模式

先判断是否需要用户确认。低风险且需求明确时，不阻塞实施：

```text
【需求确认模式】
无需确认：需求明确，修改范围低风险，继续分析。
```

以下情况必须暂停并等待用户确认：

- 需求目标、交互行为、数据来源或验收标准不明确。
- 存在多个合理方案，且会影响公共 API、配置格式、资源结构或用户体验。
- 可能破坏兼容性、迁移数据、修改大量 Prefab/场景对象、删除资源或引入新依赖。
- 用户明确要求先给方案。

不确定时读取 `references/risk-gates.md`。

## 分析模式

任何文件、代码或资源修改前必须先分析。优先使用直接工具收集上下文：

- 用 `rg` / `rg --files` 搜索现有实现、工具类、命名模式和相邻代码。
- 涉及 Unity 对象、Prefab、资源、Console 时，结合 `aibridge` 查询。
- 涉及外部库或版本敏感信息时，只查官方文档。
- 代理工具只有在用户明确要求或当前环境允许时才使用；不可伪造已启动代理。

输出 2-3 句话的综合分析结果：

```text
【分析模式】
✅ 上下文收集：已通过 rg/AIBridge 查找现有实现和约束。
✅ 综合分析：项目使用 X 模式，影响范围集中在 Y，主要风险是 Z。
✅ 复杂度评估：常规问题，可以直接实施。
✅ 实施门控：条件满足，进入方案实施。
```

## 方案实施模式

实施前必须显示当前 Skills 和已加载的关键规范：

```text
【方案实施模式】
当前匹配 Skills：aibridge-development-workflow、aibridge
已加载规范：coding-rules、risk-gates
规范已加载，开始实施方案。
```

实施要求：

- 开发业务逻辑前，搜索现有工具类和相邻实现，避免重复造轮子。
- 优先遵循项目现有命名、目录、序列化和命令风格。
- 小步修改，每个子任务完成后做对应自测。
- 复杂逻辑添加必要的简体中文注释。
- 修改 C# 或 Unity 相关逻辑前读取 `references/coding-rules.md`。

## 检查清单模式

所有开发任务结束前必须进入检查清单模式，读取 `references/checklist.md`，并按实际任务执行适用项。

输出必须包含通过、失败、已修复或不适用状态：

```text
【检查清单模式】
1. AIBridge 编译检查 ✅
2. Unity Console Error 检查 ✅
3. C# 9.0 兼容性 ✅
4. Unity 对象判空规范 ✅
5. 不适用项：Prefab dry-run（本次未修改 Prefab）

检查清单全部通过，任务完成。
```

如果检查无法执行，必须说明原因，不能假装通过。
