aibridge-development-workflow

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）

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

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