Agent Skills
返回列表
架构师手册

架构师手册

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_34a80f5d/architect-handbook。

技能介绍

你在解决什么问题

业务需求一来就拍脑袋选模式、改一处牵一片、测试和业务与 IO 焊在一起——这类问题往往不是缺一个「正确答案」，而是缺一套从需求到结构的推导方式，以及分层、依赖方向是否站得住脚。

技能如何工作

本手册把架构与设计决策拆成可执行的阅读路径，而不是一次性塞满 37 篇文档：

  • 需求推导（默认优先）：按 references/02-requirement-analysis.md 做五步分析——需求信号 → 变化因子 → 多态信号 → 隔离壁 → 模式匹配，再按需打开具体模式说明与 assets/{java,go,ts}/ 模板。
  • 架构与设计原则：整洁架构四层同心圆、依赖倒置与边界划分（00-clean-architecture.md），配合 SOLID、迪米特法则等（01-design-principles.md）。
  • 模式全集与选型：GoF 25 种语言无关说明 + J2EE 8 种 Java EE 专属；无具体需求时可走 99-decision-tree.md。
  • 代码质量：scripts/detect-anti-pattern.py 扫描 Java 源文件，覆盖 10 类常见反模式，并回链到对应模式文档做重构建议。

激活后遵循防过载：单轮最多读 3 个文件；有完整业务描述时先推导再选型，讨论阶段不强行加载 .java/.go/.ts 模板。

适用边界

聚焦结构划分、依赖关系、应对变化；纯领域规则（利率怎么算）、框架 API 用法、运维调优、一次性脚本或无明显变化信号的纯 CRUD，不必硬套手册流程。J2EE 模板仅 Java 提供，Go/TypeScript 覆盖 GoF 25 种。

使用场景

  • 业务方给出会员、订单、支付等实体与流程，并提到「后续会加类型或特殊规则」，需在编码前用五步分析法推导策略、工厂等模式组合。
  • 新服务或微服务拆分时要划分实体、用例与适配层，解决改一处牵动多处、框架绑架业务逻辑等耦合问题。
  • Java 代码评审中出现大量 `instanceof` 分支、单例线程安全或责任链中断等问题，需跑反模式脚本并对照对应模式文档给出改法。
  • 算法或实现可互换（如多种支付方式）但尚未写成完整需求文档时，用决策树定位模式并按 Java/Go/TypeScript 选用模板落地。

适合人员

  • 负责订单、计费、会员权益等模块的后端工程师，常在需求里听到「不同类型不同规则」，需要从描述推导模式而非堆条件分支。
  • 主持 Java 代码评审或重构专项的技术负责人，希望用 10 类反模式规则批量发现问题并引用手册中的重构路径。
  • 推进单体拆分、替换第三方 SDK 或统一接口层的架构师，需要整洁架构分层与依赖倒置的具体操作指引。
  • 维护遗留系统中深层 if-else 或创建逻辑分散的开发者，需要状态/策略等模式说明及 Java、Go 或 TypeScript 生产级模板对照改写。