AionUi 架构规范
为Electron多进程项目提供代码放置与结构的明确规范，确保跨进程边界不出错。
该技能仅提供代码放置和结构指南，不涉及文件系统操作、网络调用或敏感数据处理，因此权限要求极低。技能文档清晰声明了进程边界规则，并指导通过 preload 桥接 IPC，符合最小权限原则。但由于无法验证引用文档与代码库的实际一致性，且流程边界规则可能导致误用跨进程导入，因此扣分。
技能内容自洽，决策树和边界规则清晰，无相互矛盾。但所有路径和目录结构均基于引用文档，而引用文档与代码库的实际一致性未经验证。静态审查无法执行，且失败反馈机制（即无法提供可诊断的错误信息）不明确。因此得分低于快乐路径。
技能提供了明确的触发条件（创建新文件、决定代码位置等）和清晰的场景分类，但非适合范围（non-fit boundary）未明确声明。技能基于特定项目结构，对于不熟悉该项目的用户可能难以适用。同时，技能为英文，对于中文用户可能造成理解障碍，且其功能完全依赖代码库本地结构，不涉及大陆网络问题，因此不扣分。但触发条件仍可优化。
技能采用分层参考文档（process.md、renderer.md、project-layout.md），信息架构良好，有决策树和检查清单。但缺少安装/依赖说明、变更日志、版本信息和维护责任声明。许可证和来源信息在仓库上下文中清晰，但技能本身未包含这些信息。维护路径和更新方式未明确，因此扣分。
技能能够帮助用户确定代码放置位置，但能否直接完成用户任务（即正确放置代码）依赖其遵守的准确性和用户理解能力。静态审查无法验证实际输出，且技能提供的是指南而非自动执行工具，边际价值有限。因此得分低于核心任务完成。
技能内容基于项目结构，但静态审查无法执行或独立验证。仓库中存在测试和构建工作流，但不针对该技能本身，因此证据覆盖有限。作者声明和仓库结构可审阅，但缺乏针对技能的独立验证。因此得分上限为5。
- 该技能的引用文档可能随时间与代码库不同步，使用前应核对最新目录结构。
- 技能为英文，若面向中文用户，建议提供中文版本或确保中文提示词能够准确触发。
- 技能未包含维护和更新信息，用户应关注仓库的版本和变更，避免基于过时结构操作。
这个 Skill 能做什么，适合哪些场景？
这个技能是一份关于Electron多进程项目架构与文件结构的权威指南。它通过决策树、进程边界规则、命名约定和结构规则，帮助开发者确定新代码应该放在哪里，避免跨进程导入导致的运行时崩溃。技能引用了三个参考文档，涵盖渲染进程、主进程及共享层、项目根目录及monorepo布局。它源自AionUi桌面应用仓库，是开源的Apache-2.0许可。
读取项目的现有结构，并依据决策树指导代码放置——例如UI组件应放入renderer目录、IPC处理器放入bridge目录、AI平台连接放入agent目录。提供进程边界硬性规则，说明主进程、渲染进程、worker和preload各自能用什么API。给出目录和文件的命名约定（如React组件用PascalCase，分类目录用小写）。还提供测试文件映射和结构检查清单。
- 新功能开发时，不确定某个Hook或组件应放在哪个目录，使用决策树快速定位。
- 审查代码时，检查是否有跨进程导入（如渲染进程直接导入主进程服务），防止运行时崩溃。
- 将一个单文件组件重构为目录结构，需要添加index.tsx入口。
- 添加新的bridge、service或worker时，确保遵循进程边界规则。
- 为新代码编写测试时，参考测试文件映射约定。
这个 Skill 有哪些优点和局限？
- 清晰的决策树，快速确定新代码位置
- 明确的进程边界规则，防止运行时崩溃
- 详细的命名约定，统一代码风格
- 测试文件映射，测试结构一致
- 适用于Electron多进程项目，实用性强
- 未提供自动化检查工具，需手动遵循规则
- 参考资料具体路径指向AionUi仓库内部，不通用
- 未提及无头环境或CI集成
- 未包含示例或演练，初学者可能需结合项目实际
如何安装这个 Skill？
此技能已包含在AionUi仓库中，按仓库安装方式即可。通常，将仓库克隆到本地，或将对应的.claude/skills/目录复制到项目的技能目录。由于是单一技能，也可以直接将其文件夹复制到您的Agent Skills目录。
如何使用这个 Skill？
在Claude Code或兼容Agent中，触发"architecture"技能。它会分析项目并给出指导。该技能本身不自带执行脚本，而是作为知识指南。您需要遵循其规则和决策树来手动放置代码。