跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

aibridge-development-workflow

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.

FlameskyDexive · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add FlameskyDexive/Legends-Of-Heroes --skill 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)

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

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