前言¶

一个人扛前后端和运维时，性能问题往往在上线后才暴露：慢查询把数据库拖满、接口偶发超时却找不到热点路径，也没有同事能做专门的 performance review。事后救火成本高，事前又很难系统性地扫一遍反模式。

下面介绍 SkillHub 上的社区 Skill「一人公司的性能架构师 - 代码性能与架构优化助手」（坐标 @user_b833da3a/solo-architect，版本 1.0.0）。它把自动扫描和分层分析放在同一套工作流里，针对常见性能杀手给出可落地的修复思路，并强调避免过度优化。

这是什么¶

一句话定位：在 Agent 对话场景中，对指定文件或目录做性能与架构向的代码审查与优化建议的编程类 Skill。

维护与来源：发布者为 user_b833da3a，SkillHub 分类为 dev-programming，来源标注为 community；页面作者显示为 Kevin jiang。标签 requires_api_key=false，安装本 Skill 本身不强制额外 API Key。

官方页面：SkillHub - solo-architect
技能包地址：https://api.skillhub.cn/user_b833da3a/solo-architect

核心功能¶

以下能力均来自 SkillHub 页面简介，写作时不做超出原文的扩展。

自动扫描¶

可对指定文件或目录发起检测，页面说明覆盖「4 大性能反模式」。举例提到的具体问题包括：N+1 查询、阻塞 I/O、内存泄漏、无上限拉取（unbounded fetch）等常见性能风险。

分层分析¶

采用分层响应策略：简单问题走 L0 快速回答；复杂架构问题走 L2 深度诊断，减少在轻量问题上占用过多上下文。

修复方案与收益表述¶

输出侧强调「可直接复制粘贴的修复代码」，而非空泛的「建议优化」；并附带量化收益描述（页面示例表述为类似「响应时间从 8s 降至 50ms」的对比方式）。具体数字以单次分析结果为准，不宜当作通用 benchmark。

语言覆盖¶

支持 Python、Java、JavaScript、Go、Rust、C# 六种语言栈的代码语境。

防止过度优化¶

明确提到小规模数据场景不必追求极端复杂度（页面举例：百条量级数据不必强行 O(1) 方案），把精力留给真正值得改的热点。

安装与启用¶

SkillHub 推荐两种方式：用 CLI 安装到当前 Agent 的 skills 目录，或把安装提示发给 AI 按官方文档执行。

1、安装 SkillHub CLI（若尚未安装）¶

先检查是否已有 CLI：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅需要 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装说明原文：https://skillhub.cn/install/skillhub.md

2、安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录；装到错误路径时 Agent 可能无法加载技能。

skillhub install @user_b833da3a/solo-architect --dir <skills 目录>

常用客户端 skills 目录（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/
• Windsurf：~/.codeium/windsurf/skills/ 或 .windsurf/skills/

也可在对话中让 AI 按安装文档处理，页面给出的提示等价于：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_b833da3a/solo-architect`。

经过上面的步骤后，在对应客户端重启或刷新技能加载策略（以你所用 Agent 的文档为准），即可在对话中调用。

典型用法¶

官方页面未提供独立 CLI 子命令示例，典型用法是在已启用 Skill 的 Agent 里，用自然语言指向代码范围并说明目标。可复现的对话模式如下。

1、指定扫描范围，并说明关注点，例如某个 API 模块目录或单个慢接口文件。

2、要求列出检测到的反模式及对应修复代码片段，并说明预期收益表述方式（仍应以当次分析输出为准）。

3、对架构级问题（跨服务调用链、数据访问层设计）明确要求走深度分析，避免只对表面语法做轻量回复。

示例提示（可按项目改写路径与语言）：

使用 solo-architect：扫描 ./backend/services/order 目录，
重点查 N+1、阻塞 I/O 和无上限拉取；对每条问题给出可粘贴的修复代码和收益说明。

这段 Go 接口 P99 很高，请做 L2 级架构诊断，并说明是否值得做缓存或异步化，避免过度优化。

适用场景与注意¶

适合谁

• 独立开发者或小团队，缺少专职性能 review 角色，但需要在发版前或救火时快速定位热点。
• 技术栈落在官方列出的六种语言之一，且问题集中在数据访问、I/O 与常见反模式。

使用注意

• 页面定位为辅助分析与生成修复草案，不能替代压测、Profiling、生产监控与数据库执行计划等实证手段；量化收益示例是说明输出格式，不是承诺值。
• SkillHub 抓取信息显示该包下载量较高（5475 次量级），评分字段为平台展示值（100000），安装计数为 0 仅表示页面统计口径，不代表不可用。
• 复杂安全问题、合规审计或业务正确性，应结合专门流程；本 Skill 页面强调的性能项未单独展开「安全隐患」专项，勿默认覆盖安全审计范围。

结尾¶

「一人公司的性能架构师」把自动扫描、分层诊断、可粘贴修复与反过度优化约束收进一个 Skill，适合在 Cursor 等支持 SkillHub 技能的 Agent 里，对指定代码做性能与架构向的第二轮审查。

安装与详情见 SkillHub 官方页：https://www.skillhub.cn/skills/user_b833da3a/solo-architect