AI编程架构师：从架构设计到代码落地的全流程 Skill

前言¶

在开发大型或复杂软件项目时，很多开发者会陷入这样的困境：一开始需求模糊，导致后续返工；技术选型缺乏系统思考，上线后出现性能瓶颈；架构文档与实际代码长期脱节，维护成本高企。传统的做法往往依赖人工沟通和文档更新，容易遗漏细节或出现不一致。

AI编程架构师提供了一个系统化的解决方案，将AI转化为一名资深软件架构师，通过结构化的工作流，从需求澄清到架构设计，再到代码实施，确保每一行代码都有架构文档作为依据，且文档与代码在整个生命周期内保持严格一致。

是什么¶

AI编程架构师（AI编程架构师）是一个面向任意软件项目的架构设计与实施 Skill，由社区开发者 user_f243eda0 维护。它将 AI 转变为一名资深软件架构师，通过结构化的五阶段工作流（沟通→选型→文档→拆解→实施），确保每一行代码都有架构文档作为依据，且文档与代码在整个生命周期内保持严格一致。

这个 Skill 支持对任意软件项目进行架构设计与技术选型，输出可落地的架构设计文档（ARCHITECTURE.md + ADR），并基于文档逐模块实施代码，同时每次代码变更都同步回写文档，确保文档与代码始终一致。

核心功能¶

五阶段工作流¶

AI编程架构师采用结构化的五阶段工作流，每个阶段都有明确的输入和输出：

沟通阶段：通过结构化沟通澄清需求，明确项目目标、边界和约束条件
选型阶段：基于需求进行技术选型，评估不同方案的优劣，给出最佳实践建议
文档阶段：产出 ARCHITECTURE.md 和 ADR（架构决策记录）等架构设计文档
拆解阶段：将架构设计拆解为可实施的功能模块和任务清单
实施阶段：基于文档逐模块实施代码，确保每个模块都符合架构设计

文档驱动开发¶

该 Skill 的核心价值在于文档与代码的同步更新机制。在实施代码时，会同步更新架构文档，确保文档始终反映代码的实际状态。这种文档驱动的开发方式，使得架构文档不再是静态的，而是动态的、可维护的。

触发条件¶

该 Skill 在以下场景下触发：

架构设计、技术选型、系统设计
搭建项目、从零开始做
architect、architecture、设计方案、技术架构
重构架构、这个项目怎么设计
帮我规划项目结构、按架构实现、架构文档

即使在用户只说「帮我从头做一个 X 系统」「这个项目该用什么技术栈」「帮我设计一下 X 的架构」「按这个架构把代码写了」等场景下，也应触发。

注意：仅在涉及系统级架构设计、技术选型权衡、或需要「架构文档驱动的分步实施」时激活，而非局部编码任务（如「X 框架怎么用」「修一个 bug」「加一个小函数」）。

安装与启用¶

AI编程架构师基于通用 SKILL.md 格式，可以通过 SkillHub 进行安装。

安装命令¶

# 通过 SkillHub 安装
skill install user_f243eda0/ai-architect

配置说明¶

该 Skill 的标签为 requires_api_key=false，表示不需要额外的 API 密钥配置即可使用。

使用方式¶

安装后，在支持 SkillHub 的环境中（如 Cursor、Claude Code 等），直接使用触发词即可激活。例如：

输入「帮我设计一个电商系统的架构」
输入「architect architecture」
输入「这个项目该用什么技术栈」

典型用法¶

场景 1：从零开始设计一个系统¶

用户：「帮我从头做一个用户权限管理系统」

AI编程架构师会执行以下流程：

沟通阶段：澄清权限系统的需求，包括角色、权限、资源等概念
选型阶段：推荐合适的技术栈（如 Spring Security + JWT + Redis）
文档阶段：生成 ARCHITECTURE.md 和 ADR，描述整体架构和关键决策
拆解阶段：将系统拆解为用户管理、角色管理、权限分配等模块
实施阶段：逐模块生成代码，同时更新架构文档

场景 2：重构现有项目¶

用户：「这个项目怎么设计？帮我重构架构」

AI编程架构师会：

分析现有代码结构
识别架构问题（如耦合度高、扩展性差等）
提出重构方案和新的技术架构
生成重构后的 ARCHITECTURE.md
基于新架构逐步重构代码，同步更新文档

场景 3：技术选型建议¶

用户：「这个项目该用什么技术栈？」