principal-software-architect
一个扮演首席软件架构师的AI技能，专注于系统设计、架构评审和技术决策。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：principal-software-architect。 它的用途是：一个扮演首席软件架构师的AI技能，专注于系统设计、架构评审和技术决策。 完整的 Skill 内容见：https://321skill.com/skills/principal-software-architect/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“作为首席软件架构师，请评审我们这段微服务间通信的代码，并指出潜在的耦合度和可靠性问题。” 它会首先框定系统约束，然后使用内嵌的微服务生产就绪性知识库进行分析，检测出不符合`MS-*`模式的代码（`X-MS-*`），并生成一份带有严重性等级和具体改进建议的架构审查报告。
介绍
这个Skill将AI助手转化为一位经验丰富的首席软件架构师，旨在解决复杂软件系统的设计、评审和演进问题。它帮助开发者在面临技术选型、架构设计和代码审查时，获得系统化、基于最佳实践的指导，避免常见的架构陷阱。
使用时，只需在支持的AI助手（如Claude Code、Grok等）中激活该Skill，通过自然语言或特定命令（如/principal-software-architect）发起对话。它会引导你分析约束、比较方案、生成架构决策记录（ADR），并对现有代码进行深度架构审查，输出包含严重性等级的问题发现。
它非常适合需要处理复杂系统设计、进行技术决策或提升代码架构质量的专业人士。无论是初创公司定义技术栈，还是成熟团队重构遗留系统，都能从中受益。
建议在项目早期设计阶段或重大功能迭代前使用，以便尽早确立架构方向。注意，其输出基于内嵌的设计模式、整洁架构和微服务知识库，对于高度定制或非标准场景，建议结合具体业务上下文进行判断。
核心特点
该Skill的核心区别在于其深度集成了权威知识源（如《Clean Architecture》、《设计模式》原著的提炼内容），并构建了一套可执行的、基于模式检测（如`P-*`、`G-*`、`MS-*`）的审查框架，能输出机器可读的“架构基线”，而非泛泛的建议。它支持多智能体验证流程（PRIMARY → ADVERSARY → SYNTH），确保决策的严谨性。
注意事项
不适合用于快速编写简单脚本或处理与软件架构、系统设计无关的通用编程问题。
常见问题
这个Skill支持哪些AI助手？
支持Claude Code、Grok、Codex、Cursor、OpenCode等兼容Agent Skills开放格式的助手。
如何安装到当前项目供团队使用？
在项目根目录执行 `npx skills add diogoX451/principal-software-architect`（不加-g参数）即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/principal-software-architect/raw/index.md 读取 principal-software-architect 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/principal-software-architect/raw/index.md（查看排版版本）