Archai Hexagonal Architecture Analyzer
基于Bun的JS项目六边形架构分析工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Archai Hexagonal Architecture Analyzer。 它的用途是：基于Bun的JS项目六边形架构分析工具 完整的 Skill 内容见：https://321skill.com/skills/archai-hexagonal-architecture-analyzer/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用Archai分析当前项目的六边形架构合规性，并生成一份报告。”，它会调用该工具扫描你的项目目录，分析端口、适配器及依赖关系，最后提供一份详细的架构健康度评估，指出哪些模块存在不当的外部依赖耦合。或者，你可以说：“帮我检查`src/core`目录下的业务逻辑是否与`src/infrastructure`产生了直接依赖。”，它会执行针对性分析并给出结论。
介绍
Archai Hexagonal Architecture Analyzer 是一款专为基于Bun运行时的JavaScript项目设计的架构分析工具。它主要解决开发者在采用或维护六边形架构（Hexagonal Architecture）时，难以直观、自动化地分析和理解项目架构现状的痛点。通过集成MCP（Model Context Protocol），它能深入解析项目结构，评估代码与架构原则的契合度。
该工具通过命令行或脚本方式运行，扫描指定项目目录，分析模块依赖关系、端口与适配器的实现情况，并生成可视化的架构报告或数据。它帮助开发者快速定位架构违规点，如核心业务逻辑与外部依赖的耦合问题。
它非常适合正在实践或转型至六边形架构的前端、后端及全栈开发团队，尤其是那些使用Bun作为运行时或构建工具的项目。对于架构师和Tech Lead而言，它是进行代码审查和架构治理的得力助手。
使用建议：在项目关键迭代节点或重构前运行分析，以明确改进方向。注意，其分析深度依赖于项目代码对六边形架构模式（如清晰定义的端口接口）的遵循程度，对于结构松散或未明确采用该模式的项目，分析结果可能有限。
核心特点
与通用代码质量工具不同，它深度聚焦于六边形架构这一特定设计模式的合规性分析，而非泛泛的代码规范检查。同时，它是目前少数原生支持并针对Bun运行时生态进行优化的架构分析工具。
注意事项
不适合未采用或未计划采用六边形架构设计模式的项目进行架构分析。
常见问题
这个工具支持哪些JavaScript框架？
它主要分析项目结构而非特定框架，理论上支持任何基于Bun运行时的JS/TS项目，如使用Express、NestJS等后端项目或库项目。
它能自动修复架构问题吗？
不能，它是一个分析诊断工具，主要用于生成报告和指出问题，具体的代码重构需要开发者手动完成。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/archai-hexagonal-architecture-analyzer/raw/index.md 读取 Archai Hexagonal Architecture Analyzer 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/archai-hexagonal-architecture-analyzer/raw/index.md（查看排版版本）