| 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/editor-generation.md：复杂生成、分析、诊断、Runtime/Public API 调用等一次性 Editor C# 脚本规范。references/checklist.md：最终检查清单和收尾输出格式。
阶段总览
开发任务按以下模式推进：
【Skills 匹配模式】 → 【需求确认模式】 → 【分析模式】 → 【方案实施模式】 → 【检查清单模式】
简单低风险修改可以在一条回复中连续展示多个模式，但不能省略分析和最终检查清单。
Skills 匹配模式
收到开发任务后，先输出实际使用的 Skills，仅列名称：
【Skills 匹配模式】aibridge-development-workflow、aibridge
匹配规则：
- 所有开发任务至少包含
aibridge-development-workflow。
- 涉及 AIBridge CLI、Unity 编译、日志、代码文件查找、资源搜索、预制、场景或 Inspector 操作时，加入
aibridge。
- 涉及语义符号、定义、引用、实现、调用者或诊断查询时，只有
aibridge-code-index 已安装且项目规则未声明 Code Index 关闭，才加入 aibridge-code-index；否则使用 rg 和常规文件读取。
- 涉及复杂 Prefab 资源修改、批量 SerializedProperty、子物体/组件创建或引用写入时，加入
aibridge-prefab-patch。
- 涉及直接修改 Unity YAML 文本序列化文件（
.unity、.prefab、.asset、.mat、.controller 等），或 AIBridge 不支持的 Prefab/Scene/ScriptableObjectTable 结构修改时，加入 unity-yaml-editing。
- 涉及 batch、multi、批处理脚本、长脚本、stdin 或脚本自动化时，加入
aibridge-batch-script。
- 涉及创建或修改 Skill 时，加入
skill-creator。
- 涉及复杂一次性 Editor 侧 C# 任务时，读取
references/editor-generation.md，优先评估 .aibridge/code/*.csx；包括复杂资源首次生成、调用项目 Runtime/Public API、场景/资源统计、诊断报告或多步骤 UnityEditor API 编排。
需求确认模式
先判断是否需要用户确认。低风险且需求明确时，不阻塞实施：
【需求确认模式】
无需确认：需求明确，修改范围低风险，继续分析。
以下情况必须暂停并等待用户确认：
- 需求目标、交互行为、数据来源或验收标准不明确。
- 存在多个合理方案，且会影响公共 API、配置格式、资源结构或用户体验。
- 可能破坏兼容性、迁移数据、修改大量 Prefab/场景对象、删除资源或引入新依赖。
- 用户明确要求先给方案。
不确定时读取 references/risk-gates.md。
分析模式
任何文件、代码或资源修改前必须先分析。优先使用直接工具收集上下文：
- 用
rg / rg --files 搜索现有实现、工具类、命名模式和相邻代码。
- 涉及 Unity 对象、Prefab、资源、Console 时，结合
aibridge 查询。
- 涉及外部库或版本敏感信息时，只查官方文档。
- 代理工具只有在用户明确要求或当前环境允许时才使用；不可伪造已启动代理。
输出 2-3 句话的综合分析结果：
【分析模式】
✅ 上下文收集：已通过 rg/AIBridge 查找现有实现和约束。
✅ 综合分析：项目使用 X 模式，影响范围集中在 Y，主要风险是 Z。
✅ 复杂度评估：常规问题，可以直接实施。
✅ 实施门控：条件满足，进入方案实施。
方案实施模式
实施前必须显示当前 Skills 和已加载的关键规范：
【方案实施模式】
当前匹配 Skills：aibridge-development-workflow、aibridge
已加载规范：coding-rules、risk-gates
规范已加载，开始实施方案。
实施要求：
- 开发业务逻辑前，搜索现有工具类和相邻实现，避免重复造轮子。
- 优先遵循项目现有命名、目录、序列化和命令风格。
- 小步修改，每个子任务完成后做对应自测。
- 复杂逻辑添加必要的简体中文注释。
- 修改 C# 或 Unity 相关逻辑前读取
references/coding-rules.md。
- 使用一次性 Editor 脚本处理复杂生成、分析、诊断或 Runtime/Public API 调用前读取
references/editor-generation.md。
检查清单模式
所有开发任务结束前必须进入检查清单模式，读取 references/checklist.md，并按实际任务执行适用项。
输出必须包含通过、失败、已修复或不适用状态：
【检查清单模式】
1. AIBridge 编译检查 ✅
2. Unity Console Error 检查 ✅
3. C# 9.0 兼容性 ✅
4. Unity 对象判空规范 ✅
5. 不适用项：Prefab dry-run（本次未修改 Prefab）
检查清单全部通过，任务完成。
如果检查无法执行，必须说明原因，不能假装通过。
