前言¶
概要设计写完后，常见做法是人工通读一遍文档，再靠评审会口头对齐。功能点说明、需求正文、澄清记录和仓库里的实现往往分散在不同位置，单靠读设计稿很难判断方案是否覆盖需求、是否与现有代码一致。下面介绍 SkillHub 上的「设计评审」Skill，它把多类输入材料交给 Agent，按统一目标做设计方案合理性评估，并标出潜在问题与风险。
这是什么¶
「设计评审」是社区来源（community）的 Agent Skill，坐标为 @user_377751ac/wenwei-design-review，当前版本 1.0.0，分类为 dev-programming，发布者为 user_377751ac。Skill 基于通用 SKILL.md 格式分发；标签标明 requires_api_key=false，安装后无需额外 API Key。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_377751ac/wenwei-design-review
- 资源地址：https://api.skillhub.cn/user_377751ac/wenwei-design-review
核心功能¶
根据 SkillHub 简介，该 Skill 的能力可概括为以下几点：
- 以概要设计为主评审对象，评估设计方案是否合理，并识别潜在问题与风险点。
- 交叉对照多种材料：功能点梳理文档、需求文档、需求澄清记录，以及实际代码实现，避免设计脱离需求或脱离代码现状。
- 按意图触发：当用户要求进行设计评审、审查设计方案、检查概要设计、评估设计合理性，或在概要设计完成后需要验证设计质量时，适合启用此 Skill。
- 多输入形态：支持接收上述各类文档作为输入，由 Agent 在同一评审流程中综合使用。
页面侧数据（以 SkillHub 已展示信息为准）：评分 100000，下载 1375 次。
安装与启用¶
安装流程遵循 SkillHub 通用说明文档 skillhub.md。官方页面给出的安装提示为：让 AI 按该文档安装 @user_377751ac/wenwei-design-review。
1、检查或安装 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可按文档执行完整安装（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
2、安装到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；文档说明默认装到 ./skills/ 可能不会被 Agent 加载，且部分环境安装后需重启客户端。
以坐标安装「设计评审」的示例（将 <skills 目录> 换成你环境中的实际路径）：
skillhub install user_377751ac/wenwei-design-review --dir <skills 目录>
常用客户端的 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
Cursor、Codex CLI、Claude Code 的差异主要体现在 skills 目录位置；安装命令本身均为 skillhub install ... --dir <skills 目录>。未在官方资料中单独说明的配置项，本文不展开。
典型用法¶
Skill 未在公开页面上附带独立示例仓库；可复现的用法来自官方简介中的触发方式与输入类型。启用 Skill 后，在对话中明确评审目标，并附上材料路径或内容即可。
示例 1：概要设计完成后做质量验证
请使用设计评审 Skill，对这份概要设计做评审，对照需求文档和功能点说明，标出遗漏、矛盾和风险。
（附上概要设计文档、需求文档、功能点梳理文档的路径或正文）
示例 2：审查设计方案合理性
审查当前模块的设计方案是否合理，结合需求澄清记录和仓库里已有实现，给出问题清单与修改建议。
（附上需求澄清记录，并说明相关代码目录或文件）
示例 3：检查概要设计与实现是否一致
检查概要设计是否与现有代码实现一致，评估未实现或实现偏离设计的部分。
（附上概要设计 + 代码路径）
经过上面的步骤，Agent 会按 Skill 内定义的评审流程处理你提供的多类材料；具体检查项以 Skill 包内 SKILL.md 为准（安装后可在 skills 目录中查看）。
适用场景与注意¶
适合谁
- 需要在概要设计阶段做结构化评审的研发、架构或 Tech Lead。
- 手头已有功能点说明、需求、澄清记录和设计稿，希望一次性做交叉核对而非单读设计文档。
- 希望在设计落地前对照代码现状，减少「文档与实现两套故事」的情况。
使用注意
- 评审质量依赖你提供的材料完整度；缺需求或缺代码上下文时，结论只能覆盖已给信息。
- 该 Skill 不依赖 API Key，但仍受所用 Agent 与模型能力限制，不能替代正式的安全、合规或上线审批流程。
- 安装统计在 SkillHub 页面显示安装次数为 0，仅表示平台侧计数；本机是否安装成功以
skillhub install与 Agent 是否识别 skills 目录为准。
结尾¶
「设计评审」把概要设计评审从「只读设计稿」扩展为「需求、澄清、设计与代码」的对照检查，适合在设计收尾或评审会前做一轮 Agent 辅助把关。需要安装或查看详情时，请访问 SkillHub 官方页面：https://www.skillhub.cn/skills/user_377751ac/wenwei-design-review
