SWE-ATLAS
用可视化探索和工程判断，帮助 Claude Code 在动手前明确要构建什么。
- Star 数
- ★ 402
- 最近更新
- 3 个月前
- 主语言
- Python
- FA 评分
- 42/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Claude Code 的独立开发者，想先用线框图或可点击原型验证想法再生成实现。
- 不适合
- 需要脱离 Claude Code 使用的团队
- 希望用 Markdown 文件堆栈代替 HTML 规划文档的项目
这个 Agent 能做什么，适合哪些场景？
SWE-ATLAS 是面向 Claude Code 的开源模板，通过 CLI 将技能、子代理、斜杠命令和工程约定安装到项目中。它提供 Vanilla、协作式和自主式三种 CLAUDE.md 配置，其中协作式为默认选项。工作流先用 HTML 线框图、可点击原型或可视化计划探索方案，再通过问答澄清关键问题，最后将阶段内容整理成可在浏览器打开的 HTML 文档。之后由 Claude Code 原生计划模式、/goal 和工作流功能负责构建，ATLAS 还提供 QA 技能和代理。它依赖 Claude Code 生态；Playwright 浏览器自动化和 PostgreSQL MCP 可在配置时选择。
运行 npx swe-atlas@latest new-project，在当前目录或指定新目录中交互式配置并脚手架项目，可选择 CLAUDE.md 模式、技能、DESIGN.md 模板、浏览器自动化配置和 PostgreSQL。进入 Claude Code 后，/atlas:get-to-know 用于初始化项目上下文；/brainstorm:wireframe 生成单文件 HTML 线框图，/brainstorm:prototype 生成多屏 React 原型，/plan:create-phase 通过问答澄清关键事项并输出自包含的 phase.html。也可使用 /plan:visual 为重构、迁移或架构决策生成可视化 HTML 计划。用户随后将文档交给 Claude Code 的原生计划模式、/goal 和工作流功能执行；QA 命令可编写人工测试用例，并通过配置的 Playwright 集成运行测试。
- 使用 Claude Code 的独立开发者，想先用线框图或可点击原型验证想法再生成实现。
- 小型产品团队需要通过针对性问答澄清关键需求，并将阶段计划分享为浏览器可读的 HTML。
- 技术负责人要规划重构、迁移或架构变更，并希望用 Mermaid 图和决策矩阵呈现计划。
- 采用 Claude Code 原生计划与工作流的团队，想为其补充项目约定、工程技能和决策记录。
- 需要在 Playwright 支持下执行浏览器人工 QA 的项目团队。
如何安装或部署这个 Agent？
需要 Claude Code 和可用的 Node.js/npm 环境。CLI 的快速入门命令如下：
npx swe-atlas@latest new-project也可指定新目录：
npx swe-atlas@latest new-project my-workspace若手动设置，可克隆仓库及其子模块：
git clone --recurse-submodules https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas
cd Software-Engineer-AI-Agent-Atlas脚手架会询问 CLAUDE.md 模式、技能、设计模板和可选集成。README 未给出 Node.js 版本要求，也未说明 Claude Code 的安装步骤。
如何使用这个 Agent？
在 Claude Code 中先运行：
/atlas:get-to-know一种典型流程是：
/design:create-design-md
/brainstorm:prototype
/plan:create-phase "phase-01-mvp"随后切换到 Claude Code 计划模式，让它根据生成的 phase.html 开始构建。需要规划非 UI 变更时，可使用 /plan:visual "what to plan"。如选择 Playwright CLI，README 提供了安装命令：
npm install -g @playwright/cli@latest这个 Agent 有哪些优点和局限？
- 提供 HTML 线框图、可点击 React 原型和可视化计划，能在实现前审视方案。
- 阶段规划通过针对性问答聚焦关键未知项，并将线框图、数据流和决策矩阵收进一个 HTML 文件。
- 包含三种 CLAUDE.md 模式、17 个技能、6 个代理和按领域组织的斜杠命令。
- 自主模式的
free-will技能会记录重要决策、备选方案及理由，便于后续审查。
- 核心工具面向 Claude Code，不能据此认定兼容其他模型提供商或 Agent 平台。
- 用户需要具备 Node.js/npm、终端和文件系统使用条件；完整流程还需熟悉 Claude Code 命令。
- Playwright MCP、Playwright CLI 和 PostgreSQL MCP 是可选集成，但会增加相应配置工作。
- README 没有明确列出 Node.js 版本、许可证详情或使用成本。
这个 Agent 与同类方案有什么区别？
与 README 提到的 spec-kit、BMAD、Get Shit Done 等规格驱动开发框架相比，ATLAS 以线框图、原型和单个 HTML 阶段文档为前期探索与规划载体，再交给 Claude Code 原生计划、目标和工作流功能执行；它强调减少多份 Markdown 规划文件及多阶段流程。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| SWE-ATLAS 当前 | 42 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 402 | 3 个月前 | Python | Claude Code |
| InPlan 交互式规划编辑器 | 81 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 24 | 1 个月前 | TypeScript | Claude Code |
| Okto Pulse | 80 · 表现良好 | 命令行工具免费 | ★ 51 | 2 天前 | Python | Codex · Claude Code |
| Smart Ralph | 73 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 559 | 1 个月前 | Shell | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示脚手架技能默认不预选，数据库 MCP 为可选，浏览器自动化配置提供隔离或持久配置；协作模式保留审查与提交循环。这些选择支持用户控制，因此用户确认得 2 分。扣分在于自主模式明确移除审批循环并允许无人值守决策，且提供数据库访问和浏览器自动化集成，但材料没有权限范围、数据流细节、敏感数据防护、回滚或撤销说明。依赖安全仅见 Playwright CLI 安装说明，未见审计或缓解机制。
README 对产品流程和目录结构有较多说明，但描述中既强调原生 Claude Code 计划与工作流，又称 ATLAS 自带执行与 QA 能力；这些职责边界有一定模糊，故自洽性为 1。列出了 Node.js 18 以上以及外部 MCP、Playwright CLI 和子模块等前置条件，但没有故障提示或恢复路径说明。
材料面向 Claude Code 用户，说明了线框、原型、规划、QA 等场景，并列出三种 CLAUDE.md 模式和多种按需安装技能，普通用户可据此选择适用方式。自主模式的触发描述包含若干机械条件，但“中高风险”等判断仍较宽泛；配置环境涉及 Node、Claude Code、MCP、PostgreSQL 和浏览器工具，环境适配说明不完整。
README 通过目录、命令、集成和快速开始组织信息，并给出可操作的安装命令、典型流程及 FAQ 风格的对比说明；命名有清晰的命令域和技能表。package.json 声明 MIT、作者与版本号，因此许可证得 2 分。扣分原因是缺少明确的已知限制、变更日志和维护责任说明；作者字段本身不足以证明维护责任或更新机制。
线框、可点击原型和单文件 HTML 阶段文档等输出形式具体且可供后续 Claude Code 流程使用，且按需选择技能可能减少不必要安装。README 对节省 token、提高产出质量等收益主要是产品方陈述，未有比较数据；同时 HTML 生成成本更高，且无人值守模式可能需要额外审查，因此成本收益证据有限。
README 和 package.json 支持部分可核实事实，例如命令、版本、Node 要求及 MIT 元数据；但主要效用与质量主张多为陈述，材料没有测试或独立佐证，故跨来源佐证较弱。README 中有若干清晰标为产品功能的描述，但实证事实与推断性宣传并未始终区分。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 自主模式移除审批循环；在无人值守运行前，应仔细核对决策日志以及可用工具和集成的权限范围。
- 材料未说明凭据、浏览器持久配置或数据库数据的处理和清理方式，也未说明操作失败时的恢复办法。
- 节省 token、质量提升和“一次生成应用”等效果未由所给材料中的比较数据或独立证据验证。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
Full Changelog: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/compare/v2.6.3...v2.6.4在 GitHub 查看 ↗ -
发布说明摘录
Full Changelog: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/compare/v2.6.2...v2.6.3在 GitHub 查看 ↗ -
发布说明摘录
Full Changelog: https://github.com/syahiidkamil/Software-Engineer-AI-Agent-Atlas/compare/v2.6.1...v2.6.2在 GitHub 查看 ↗
常见问题
它能在 Codex 或其他编码助手中运行吗？
使用它需要配置哪些服务或密钥？
能否无人值守地生成应用？
/atlas:oneshotapp "idea"，包含自动决策、构建循环和审查步骤；这依赖 Claude Code，且自主模式会移除审批循环。阶段规划会输出什么？
/plan:create-phase 输出自包含的 phase.html，可包含低保真线框图、澄清结果和决策矩阵，供 Claude Code 计划模式使用。