ASE 完全指南：用 20 个工程化技能武装 Claude Code
Claude Code 作为一款出色的 AI 编码 Agent，能帮你写代码、改 Bug、做重构。但如果你希望它不只是「写代码的助手」，而是像一个资深工程师那样遵循规范、审查代码、分析架构、生成 Changelog，那就需要 ASE（Agentic Software Engineering）。
ASE 是 Dr. Ralf S. Engelschall 开发的开源工具包（Apache-2.0，GitHub 32⭐），它为 Claude Code（以及 Copilot CLI、Codex CLI）注入了 20 多个结构化的工程化技能——从代码审查、架构分析、文档校对，到多方案决策矩阵、计划压力测试、根因分析。每个技能都是一条斜杠命令，一键调用。
本文完整介绍 ASE 的安装、核心技能和最佳实践。
ASE 是什么
ASE 的核心理念很直接：AI 编码 Agent 应该像工程师一样工作，而不是像初级程序员那样只盯着当前行。
传统 Claude Code 会话中，你要”对 Agent 说清楚每一步想做什么”。有了 ASE 后，你可以：
/ase-code-review— 让 Agent 像资深 Reviewer 一样审查 staged changes/ase-arch-analyze— 分析模块耦合度，发现架构坏味道/ase-meta-diff— 把 Git diff 转成结构化、带风险等级的 Changelog/ase-task-grill— 对你的计划进行压力测试，直到没有盲点
ASE 的架构分三层：CLI 工具（ase 命令，负责安装和管理）、Claude Code 插件（注入的 Hook + Slash Command 技能）、以及可选的 MCP 服务（连接外部的 ChatGPT、Gemini、Perplexity 等，辅助高质量结果）。
安装
ASE 的安装分两步，核心只有一个 npm install 加一个 ase setup install。
前提条件
- Node.js（ASE 是 TypeScript 项目，运行时依赖 Node）
- Claude Code（首选）/ Copilot CLI / Codex CLI
安装 ASE CLI 和插件
npm install -g @rse/ase ase setup install --tool claude --scope user
--scope 有三个选项：
user（默认）— 全局生效，所有项目共享project— 通过 Git 分享给团队（注册文件提交到仓库）local— 仅当前机器当前项目，不提交版本控制
更新
ase setup update --tool claude
卸载
ase setup uninstall --tool claude
启用外部 MCP 服务（可选）
ASE 的一些技能可以连接外面的 LLM 和搜索服务来提升质量：
ase setup mcp list ase setup mcp activate --tool claude openai-chatgpt,brave
每个 MCP 服务器通过环境变量 ASE_MCP_KEY_XXX 提供 API Key（例如 ASE_MCP_KEY_OPENAI_CHATGPT），ASE 也支持从 .env 文件自动读取。
核心技能详解
ASE 提供了 20+ 条斜杠命令。以下是按应用场景分组的核心技能。
代码质量与审查
/ase-code-review — 审查 staged Git 变更。它会像人类 Reviewer 那样逐行阅读 diff，给出 approve/reject 判断，以及按严重性分级的发现列表（含行号引用）。
/ase-code-review
输出：一段英文审查报告，包含 verdict（approve/reject）、优先级排序的 findings（每一条有 severity 标签和 line 引用）。
/ase-code-lint — 词法级别的代码分析，检查常见质量问题（命名、可读性、复杂度等）。
/ase-code-lint @tool/src/*.ts
/ase-code-analyze — 逻辑级别分析。不只看语法，还看控制流、语义问题。
/ase-code-analyze @tool/src/*.ts
/ase-code-explain — 代码理解。按 What / Why / Analogy / Diagram / Cruxes / Gotchas 六个维度解释一段代码。
/ase-code-explain @tool/src/*.ts
架构与设计
/ase-arch-analyze — 架构分析。评估模块内聚度和模块间耦合度，定位架构中的弱点和坏味道。
/ase-arch-analyze @tool/src
/ase-arch-discover — 包发现。当你需要选型时（”我需要一个响应式 UI 渲染库”），ASE 会帮你从生态中找到合适的包。
/ase-arch-discover "reactive UI DOM rendering"
计划与实施
/ase-task-edit — 创建命名的、跨会话持久的计划。比 Claude Code 的 Plan Mode 更结构化——每个计划可命名、跨会话访问、严格分步。
/ase-task-edit hello
/ase-task-grill — 计划压力测试。对你定好的计划发起全方位拷问，从每一个隐藏的假设到决策盲点，直到你和 Agent 对计划达成共识。
/ase-task-grill hello
/ase-task-preflight — 实施前的预演。先模拟执行关键步骤，确认影响范围，避免事后用版本控制回滚。
/ase-task-preflight hello
/ase-task-implement — 按命名计划执行实施，作为单一的完整变更集（而非多个零散的小修改）。
/ase-task-implement hello
/ase-code-craft — 替代方案漏斗。你想要一个 Plan-driven 的实现，但不是直接写代码，而是先走一个”多方案→筛选→最优”的漏斗。
/ase-code-craft hello: "ase hello CLI command which prints a nice Hello World in red"
文档与校对
/ase-docs-proofread — 文档校对。检查拼写、标点、语法错误。
/ase-docs-proofread @README.md
/ase-docs-distill — 关键点蒸馏。把一份文档压成重要度排序的关键点列表，每一点有 rationale + verbatim 行引用。
/ase-docs-distill doc/architecture.md
变更管理
/ase-meta-diff — Diff 摘要。把原始 Git diff 转化成结构化的变更叙述，包含 intent-coherence check、risk grading、blast radius。
/ase-meta-diff -c -r -b
/ase-meta-changelog — 自动生成 CHANGELOG.md。从近期 Git commits 中推导变更条目。
/ase-meta-changelog
研究与分析
/ase-meta-quorum — 研究法定人数。同时查询多个外部的 LLM（如果有配置），用方法论的法定人数推导出共识答案。
/ase-meta-quorum "What is Agentic Software Engineering?"
/ase-meta-why — 根因分析。用”五次为什么”方法找到问题根本原因。
/ase-meta-why "is the Decibel (dB) unit a logarithmic one?"
/ase-meta-search — 搜索合并。同时查询多个搜索引擎，返回合并结果。
/ase-meta-search "What is Agentic Software Engineering?"
协作与决策
/ase-meta-brainstorm — 协作头脑风暴。先发散（大规模想法生成），再收敛（聚类和打分），最后产出推荐方向。
/ase-meta-brainstorm "an offline-first sync layer for the mobile app"
/ase-meta-evaluate — 多标准决策矩阵。用带权重的决策矩阵系统性评估多个候选项。
/ase-meta-evaluate "Vue vs. React vs. Angular, focus on TypeScript support and extensibility"
/ase-meta-diaboli — 魔鬼代言人。对你的论点无差别地挑战，最后通过黑格尔式综合收敛到平衡结论。
/ase-meta-diaboli "The Decibel (dB) is an intuitive unit."
/ase-meta-steelman — 钢人论证。把你的论点用最强的形式表述出来，然后巩固成防御性论点。
/ase-meta-steelman "ASE is one of the best Anthropic Claude Code CLI add-ons."
同步与自动化
/ase-sync-reconcile — 制品对齐。让一组制品（如 CODE 和 DOCS）自动对齐到另一组的状态（如 SPEC 和 ARCH），支持单向或双向。
/ase-sync-reconcile -s SPEC -t DOCS
/ase-sync-import — 外部源导入。将外部文件、URL 或粘贴文本结构化后导入为 SPEC、ARCH、CODE、DOCS 或 TASK 制品。
/ase-sync-import -t SPEC @requirements.txt
/ase-sync-export — 制品导出。将制品物化为衍生文件——如把 Data Model 渲染为 SVG 图，或把 Technology Stack 渲染为 Markdown 表。
/ase-sync-export -s SPEC,ARCH
实战场景：两个真实案例
场景 1：用 ASE 做代码审查
假设你写了一个新功能，已经 git add 但还没 push。传统做法是自己 review 一遍，或者手动给 Claude Code 看 diff。用 ASE：
/ase-code-review
ASE 会做的事：
- 读取 staged diff
- 逐块分析，识别逻辑错误、未处理边界、代码异味
- 给出 approve/reject 判断
- 按 severity（critical / major / minor / info）列出所有发现
- 每一条发现附带 line 引用和修改建议
这比直接问 Claude “帮我 review 一下代码”要结构化得多——它是一个有方法论、有输出格式、有 verdict 的确定性流程。
场景 2：用 ASE 做架构分析
你接手了一个遗留代码库，想知道模块间耦合情况。传统做法：手动翻文件，或者用 madge 等工具。用 ASE：
/ase-arch-analyze @tool/src
输出会包含：
- 每个模块的内聚度评估（高内聚 / 低内聚）
- 模块间的耦合关系图（谁依赖谁）
- 推荐的解耦方向
最佳实践
- 从
/ase-task-grill开始再动手：做任何重要的改动前，先让 ASE 对你的计划做压力测试。这个习惯能避免一半的返工。
- 为每个仓库创建一个命名计划：使用
/ase-task-edit创建跨会话的命名计划，这样第二天回来还能接着做，不用从头和 Claude 说话。
- 组合使用
/ase-code-craft+/ase-task-implement：先通过替代方案漏斗（craft）确定最佳路径，再按计划执行（implement）。这样改出来的代码更可靠。
- 用
/ase-meta-diff生成 PR 描述：提交前跑一次/ase-meta-diff -c -r -b，它会生成一份包含变更一致性检查、风险分级和影响范围的 PR 描述——直接粘贴到 GitHub 上即可。
- 外用 MCP 服务提升质量：如果你有 ChatGPT 或 Gemini 的 API Key，
ase setup mcp activate激活后，ASE 的 research、quorum、review 等技能可调用外部 LLM 交叉验证结果，显著减少幻觉。
注意事项
- 外部 MCP 服务需要 API Key：ASE 的
/ase-meta-quorum、/ase-meta-search、/ase-meta-chat等技能在无外部服务时质量会下降。建议至少配一个搜索类的 MCP（如 Brave 或 Perplexity）。 - 语言限制：ASE 的核心是 Claude Code 插件，技能输出以英文为主。中文项目中使用时，
/ase-meta-diff和/ase-code-review的报告是英文的。 - npm 安装：ASE 依赖 Node.js/npm 生态。如果你的开发环境没有 Node.js，需要通过其他方式安装。
- 开源免费：ASE 采用 Apache-2.0 许可证，完全免费，无隐藏付费功能。
总结
ASE 不是又一个 AI 编码工具——它是为 Claude Code 和其他 AI 编码 Agent 注入工程化方法论的插件平台。20+ 条斜杠命令覆盖了代码审查、架构分析、变更管理、文档处理、决策支持等多个维度，让 AI Agent 从”助手”升级为”协作工程师”。
如果你是 Claude Code 的用户，并且希望你的 Agent 不只是写代码快，而是写得规范、分析得深入、改得安全，ASE 值得一试。
- GitHub: https://github.com/rse/ase
- 官网: https://ase.tools
- npm:
@rse/ase - 许可证: Apache-2.0
相关链接