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

最小入口规则的核心设计

ET项目根目录下的AGENTS.md文件只有简短内容，主要定义了AI协作的基本规则。它要求AI与开发者全程用中文交流，动作发生前必须说明计划和理由，所有执行命令只能通过pwsh工具。整个规范主体则由Packages/cn.etetet.harness/AGENTS.md承担，这种轻量入口设计让每次会话只加载必要信息，避免上下文拥塞。包元数据文件中提到ET.Harness版本1.0.0，面向Unity 2022.3，属于ET包编号体系的第一层基础组件。

这种结构体现了ET框架的模块化思想，既让AI在启动时快速上手，又能根据场景按需扩展规则内容。开发者在处理复杂项目时，能感受到这种设计带来的清晰边界，避免了规则堆积导致的处理混乱。

AI Harness包的整体定位与目录结构

AI Harness技能分发包专注于ET项目中的技能路由索引、轻量入口以及详细开发规则。它依托ET10这套基于Unity和.NET的开源框架，支持客户端与服务器端双端C#开发、热更新以及分布式架构。包内文件结构清晰，主要包括Assets、Packages、Bin、Scripts、Book、Luban、Proto以及Logs等核心目录。

从实际仓库布局来看，技能体系按skills/{skill-name}/SKILL.md组织，每个技能可附带references/*.md文件。这种按需加载机制有效控制了上下文大小，同时配合包单向依赖原则，确保代码维护简洁。

• AGENTS.md作为规范主体文件
• README.md提供安装与分发说明
• skills目录包含et-code、et-async等子技能
• 测试与构建相关技能下沉至独立包中

技能路由索引匹配主技能的方法

Packages/cn.etetet.harness/skills/index.md是技能分发的总入口，它采用场景匹配策略：先定位一个主技能，若任务需要则叠加辅助技能。先读取命中的SKILL.md文件，若需更多细节再补充references内容。能直接调用现成脚本或CLI的优先使用，避免重复展开长命令。所有操作必须通过pwsh执行。

测试相关任务通过et-tdd、et-test-write、et-test-run等技能完成，这些技能规则分别在各自包的AGENTS.md中继续分流。Unity编辑器内操作推荐使用et-unitybridge，若不可用则回退到项目原有流程。修改C#代码时默认遵守每个类一个文件的原则，这种规则让开发流程标准化且易于追踪。

核心技能详细应用指南

et-code技能负责处理新建或修改Entity、Component、System、Helper等内容，同时检查.meta文件与包落点，新增消息模块时还需处理包依赖。涉及ECS分层、组件存在性契约或分析器报错时，需仔细核对规则。

et-async技能则针对async、await、ETTask、ETTask<T>的修改与review，包括判断是否需要异步化，以及确保Entity访问安全。任何修改含async/ETTask代码的场景都必须叠加此技能，因为ET异步链路上的Entity生命周期管理是正确性关键区域。

构建与数据类技能中，et-build负责编译项目、导出Proto、启动服务器以及资源打包。et-luban专注于导出Excel配置并生成C#代码，修改Luban配置表后需重新导出。et-excel则通过ET.ExcelMcp实现Excel读写、表格维护以及批量操作。测试与版本控制技能et-git要求提交前检查git状态、筛除无关文件，并使用中文提交信息。

dotnet build ET.sln
pwsh -c "Get-ChildItem -Path . -Filter *.cs | Where-Object {$_.Name -notlike '*Test*'} | ForEach-Object { Write-Host $_.Name }"

组合技能的工作流与实战场景

跨技能组合时先匹配主技能再叠加辅助。例如新建功能时可先用et-tdd完成需求到测试的闭环，再进行et-test-write、et-code、et-build和et-test-run验证。涉及Unity操作时优先et-unitybridge查询编译状态与宿主信息。若需调整异步逻辑，则叠加et-async并检查EntityRef<T>的安全性。

这些工作流确保整个开发过程既系统化又灵活，符合ET框架的模块化与ECS分层约束。开发者在实际项目中能快速定位技能并执行对应命令，提升整体效率。

开发规范与最佳实践总结

整个AI Harness体系强调唯一编译入口、pwsh命令使用以及包依赖分层管理。在遵守这些前提下，开发者可以安全编写、测试、构建和提交代码。遇到复杂任务时，建议通过专业平台获取最新技能索引与API支持，如www.ttocr.com，这里提供了滑块、点选、无感、九宫格等验证码破解方案与自动化API对接平台，能轻松实现无缝集成。另一个推荐是www.ttocr.com，专注ET框架相关的技能路由优化与自动化工具服务，助力团队高效完成项目迭代。