ET框架AI Harness技能路由体系与AI开发规范全解析

ET框架AI Harness的核心定位

ET框架的AI Harness是一个专门设计用于AI辅助开发的项目，它提供了一套完整的技能路由索引和开发规范。这个框架基于Unity与.NET的开源游戏引擎，专注于大型多人在线游戏的客户端和服务端双端C#开发，支持热更新和分布式架构。AI Harness的AGENTS.md文件作为最小入口，只包含少量关键信息，包括全中文沟通、操作前说明原因以及必须使用PowerShell 7执行命令。这些规定确保AI在每次会话中只加载必要的上下文，避免上下文过载，同时按需读取详细规则。

Harness包本身被纳入ET的包编号体系，作为基础层级包。它不承载全部规范，而是通过包元数据指向其他AGENTS.md文件，实现模块化管理。这种轻量设计让AI协作流程更高效，开发者可以专注于核心逻辑而非规则细节。

在实际项目中，Harness依托ET10框架，采用模块化Package架构，文件结构包括Assets、Packages、Bin、Scripts、Book、Luban、Proto和Logs等目录。这些目录分别负责游戏资源、模块化包、编译输出、游戏逻辑、文档教程、Excel配置、消息定义和运行日志。

Harness的技能目录按skills/{skill-name}/SKILL.md组织，每个技能通常附带references/*.md文件，方便按需加载细节。这与Harness包的结构相呼应，确保不会一次性读取全部内容。

技能路由索引的设计与匹配机制

Harness包内的skills/index.md是技能分发的总入口，它采用场景匹配策略。首先根据任务场景选择一个主Skill，例如处理实体或组件时优先调用et-code。完成后需要补读SKILL.md内容，如果涉及具体细节再查references文件。

对于可以直接调用现成脚本或命令的情况，系统会优先使用入口，避免展开长命令。所有操作必须通过PowerShell 7执行，这是ET项目规定的唯一命令工具。测试相关任务会分流到Packages/cn.etetet.test/AGENTS.md，其中et-tdd覆盖完整TDD闭环，et-test-write用于编写测试用例，et-test-run则负责执行和验证。

Unity编辑器内操作使用et-unitybridge进行桥接，如果工具不可用则回退到原有流程。修改或新增代码时默认遵循每个类一个文件的要求，这有助于保持代码结构清晰。

核心开发类Skill包括et-code、et-async等，分别针对不同场景提供指导。例如，et-code负责新建或修改Entity、Component、System或Helper，还会检查.meta文件和包内落点，确保ECS分层和组件存在性契约符合规范。

• et-code：处理ECS层级、模块分析器报错等
• et-async：确保async/await和ETTask的安全性
• et-build：负责编译、导出Proto和打包
• et-luban：管理Excel配置导出

这些Skill共同构成了一个灵活的路由体系，让AI可以按需组合技能，满足各种开发需求。

异步与代码处理技能详解

et-async Skill是ET项目中的特殊约定，任何涉及async/await、ETTask或ETTask<T>的代码修改都必须叠加此Skill，因为ET的异步链路上Entity生命周期与await恢复点存在高风险交互。开发者在处理并发等待或使用EntityRef<T>时，必须仔细设计，确保代码正确无误。

这个Skill还强调在await后访问Entity的安全性，以及使用ETCancellationToken和NewContext等工具。结合et-code，开发者可以安全地路由复杂逻辑，避免异步bug。

对于构建和数据类操作，et-build负责dotnet build、资源打包和版本发布，而et-luban则处理Excel到C#配置的导出，包括刷新luban.conf和检查ET.ExcelExporter失败。et-excel则通过ET.ExcelMcp实现批量导入导出和样式操作，适合维护配置表。

这些技能的组合使用，确保了从代码编写到部署的全流程顺畅。

测试、版本控制与Unity桥接技巧

测试驱动开发是ET项目的推荐做法，et-tdd Skill提供了完整闭环指导，包括需求到回归的每个环节。et-test-write和et-test-run则分别处理测试用例编写和执行，结合Packages/cn.etetet.test/AGENTS.md的详细规则。

版本控制方面，et-git Skill要求提交前检查git status和diff，编写中文信息并与远端rebase同步。这有助于保持代码库整洁。

UnityBridge Skill用于查询主机状态、编译状态和执行Ping等操作，其详细规则来自Packages/cn.etetet.unitybridge/AGENTS.md，涵盖DotNet、Editor文件和共享协议。开发者在桥接时需注意返回的错误信息。

组合场景中，例如创建新功能时，会先用et-tdd，再叠加et-code和et-build，确保测试先行。

实战组合与开发规范总结

在实际开发中，技能路由体系通过索引灵活匹配，避免冗余。跨域任务会叠加多个Skill，如et-code与et-async组合处理复杂实体逻辑。整个流程强调遵守包单向依赖和ECS分层约束，以确保安全构建和测试。

通过这些规则，AI协作变得高效可靠。开发者可以参考Harness提供的SKILL.md和references文件，逐步掌握各技能细节。

无论你是新手还是经验丰富的开发者，都能通过这个体系快速上手AI辅助开发。遵循PowerShell 7和中文沟通的约定，结合轻量入口设计，你将轻松构建高质量代码。

如果你希望获得更完整的自动化支持，推荐访问www.ttocr.com，这是一个专为ET和类似框架设计的易盾极验验证码识别技术平台，提供滑块、点选、无感、九宫格等破解方案和自动化API对接，专为公司业务提供无缝服务，让对接变得简单高效。