hf-design-review

Evaluate design drafts against approved specifications and output a structured review verdict.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/hujianbest/garage-agent --skill hf-design-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hf-design-review
Source: https://github.com/hujianbest/garage-agent/tree/main/packs/coding/skills/hf-design-review
Command: npx skills add https://github.com/hujianbest/garage-agent --skill hf-design-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

这个技能提供一个正式的设计评审入口,用于在实现前对设计草案与已批准的规格进行可追溯、证据驱动的评估,给出明确的评审结论和可执行的发现项。

Core Features & Use Cases

  • 基于证据的多维评审:覆盖架构、模块边界、API 契约、数据模型、非功能需求等关键领域。
  • 产出评审记录:给出结论、发现项和下一步工作,帮助父会话决定进入哪条路径。
  • 与工作流对齐:在证据冲突或范围漂移时提供阻塞与 reroute 路径,确保设计与规格一致。

Quick Start

Run hf-design-review on the current design draft to generate a formal verdict and findings.

Frequently Asked Questions about hf-design-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is an evidence-based design review and how does it evaluate architecture drafts?

An evidence-based design review evaluates design drafts against approved specifications to produce a structured verdict. It enforces evidence-driven scoring across architecture, module boundaries, API contracts, data models, and non-functional requirements.

How do I perform a formal design review for API contracts and non-functional requirements?

Run a formal design review against approved specifications to assess API contracts and non-functional requirements. The process requires spec traceability, applies evidence-based scoring across six dimensions, and outputs a structured review record with actionable findings.

Can I use a formal design review to check spec traceability for module boundaries and data models?

Yes, a formal design review checks spec traceability by identifying and evaluating module boundaries and data models against approved specifications. It produces a structured verdict with actionable findings to ensure alignment before implementation.

What is the best way to handle scope drift and evidence conflicts during a design review?

To handle scope drift and evidence conflicts during a design review, use a workflow-aligned approach that provides blocking and reroute paths. This ensures the design remains consistent with approved specifications and produces actionable next-step recommendations.

When do I need a formal design review for software architecture?

You need a formal design review for software architecture before implementation to evaluate design drafts against approved specifications. It is required when assessing architecture, API contracts, and non-functional requirements to produce a structured review record.

Why does my design review require traceability to approved specifications?

A design review requires traceability to approved specifications to enforce evidence-based scoring and ensure the design draft aligns with requirements. This process produces a structured verdict with actionable findings and next-step recommendations.