styleseed

1. 基本信息

项目	内容
名称	styleseed
作者/维护者	bitjaru（个人开发者，GitHub 账号注册于 2016 年，全栈工程师/CTO 背景）
来源链接	https://github.com/bitjaru/styleseed
许可证	MIT（仓库 LICENSE 文件确认）
GitHub Stars / Forks	794 / 70（GitHub API 实测）
最新版本	v3.0.0（2026-07-18 发布，GitHub Releases 确认）
安装方式	一条命令：`npx skills add bitjaru/styleseed`（详见第 10 章）

2. 功能介绍与亮点

styleseed 是一个面向 AI 编码工具的“设计引擎”，核心思路不是喂给模型更多配色数据，而是把资深设计师的隐性判断写成可执行规则：

74 条设计判断规则：覆盖色彩克制（如“最精致的黑不是 #000 而是 #2A2A2A”）、数字与单位 2:1 比例、嵌套圆角、低透明度阴影、8px 空间网格等准则，逐条附带理由
评分门禁（Quality Gate）：/ss-score 在 UI 生成后自动打分（0–100），低于阈值时列出问题并自动修复，而非生成完就算完成
反漂移设计锁：决策写入 STYLESEED.md，每次对话重新读取遵守，避免同一项目跨会话风格跑偏
8 种输出语法 + 5 种呈现适配器：区分消费级产品、运营控制台、技术工具、编辑阅读、电商转化等场景该用的设计语法，并可扩展到社交卡片、幻灯片、文档等非网页输出
参考编译器 /ss-reference：可把截图、URL、Figma 导出编译成项目专属设计语法，而非简单照抄画面
7 套品牌皮肤：Toss / Stripe / Linear / Notion / Raycast / Arc / Vercel 风格的配色与圆角基调，一条命令切换

3. 适用场景

所属分类：前端与设计

适合用 Claude Code、Codex 等 AI 编码工具搭建产品界面、但自己不是专业设计师、担心产出“一眼假 AI 生成”的独立开发者与小团队；也适合已经用 Anthropic 官方 frontend-design 之类脚手架技能快速出图、但想再叠加一层设计判断和自动质检的场景。仓库明确说明它是“评审 + 强制执行”层，可以和纯脚手架类技能配合使用而非互相替代。

4. 跨 Agent 兼容性

Claude Code：原生支持，通过 CLAUDE.md + .claude/skills/ 下的 /ss-* 命令使用（官方文档明确列出）
Codex：原生支持，通过 AGENTS.md + .agents/skills/ 下的 $ss-* 命令使用，README 专门提到近期版本加入了“Codex 优先发现”的改进
OpenClaw：未验证——官方文档未提及该平台
Hermes Agent：未验证——官方文档未提及该平台

以上判断仅基于已抓取的仓库文档，未为兼容性单独发起搜索。

5. 推荐理由

多数“帮 AI 做设计”的项目只是把配色 token 喂给模型，styleseed 的作者实测过这条路——把 Toss 的完整设计 token JSON 塞进 prompt，产出依旧很通用——转而把“该怎么用这些数据”的判断力本身写成规则。它额外做了两件同类项目少见的事：生成后自动打分并修复，以及把设计决策锁定下来防止跨会话漂移。对于用 AI 编码工具搭界面、又缺乏设计训练的用户，这类“质检+强制执行”层能实打实减少“看起来很 AI”的观感问题。

6. 评分

维度	分数	说明
受欢迎程度	7	GitHub 794 星（3.5 个月内从 0 增长而来），且被 GitHub Trending 收录、Hacker News Show HN 发帖讨论（24 points）、第三方技能目录站 SkillsLLM 标记为“已验证”
可用性	8	`npx skills add bitjaru/styleseed` 一条命令覆盖 Claude Code/Codex 等多个 agent，文档详尽（架构图、变更日志、交互式设置向导）；v3.0.0 于 2026-07-18 发布，维护极活跃；扣分点：一位用户曾反馈早期文档假设用户熟悉 git 命令且命令名与实际不符（见第 8 章），暴露过对新手不够友好的粗糙点
安全性	8	逐项检查：①代码执行仅限一个本地校验脚本 `validate-engine.mjs`，用途明确（工程规则一致性校验），无广泛 shell 权限；②仓库自述“无后端、无运行时服务”，未发现外联行为；③不要求任何 API Key 或凭据；④SKILL.md 与规则文件通读未发现可疑指令；⑤作者为有 10 年账龄的活跃个人开发者，对已提交 issue 响应及时；⑥MIT 许可证明确；⑦2026-07-18 仍有发布，维护活跃。第三方平台 SkillsLLM 于 2026-05-27 对其做过依赖漏洞审计与 prompt-injection 启发式扫描，结果为“无高危问题”

综合评分：7.7

7. 跟同类 Skills 相比的优势

项目	定位	与 styleseed 的差异
Anthropic 官方 `frontend-design`（anthropics/skills 仓库内）	官方脚手架技能，快速搭出结构完整的页面	负责“从无到有”，不含具体的美学判断规则库，也没有生成后自动打分/修复的质检环节；styleseed 官方文档建议两者搭配使用而非二选一
design-dna（zanwei/design-dna，1052★，MIT）	把参考截图/URL 分析成结构化的“设计 DNA” JSON（token+风格+特效三维度），再依据 JSON 生成界面	长于“从一个具体参考里提炼可复用规范”，是数据提取型思路；styleseed 走的是反过来的路线——不依赖具体参考，靠一套通用的设计判断规则加评分门禁来防止“看起来像 AI 做的”，两者可以配合（先用 design-dna 提炼品牌 DNA，再用 styleseed 的质检门禁把关）

8. 用户评价

GitHub Issue #1（bitjaru/styleseed#1）：开发者 binaryitsolutions 反馈早期安装文档对非技术用户不友好，且文档列出的部分命令名与实际不一致。作者 bitjaru 确认后修复文档与 wiki，issue 随后关闭。
Hacker News「Show HN」讨论（news.ycombinator.com/item?id=48920888，24 points）：评价两极。用户 AnthonyR 指出展示的品牌皮肤目前主要是切换配色与圆角，并非复刻品牌完整设计系统；用户 james2doyle 用 Lighthouse 审计发现展示页存在无障碍访问问题。

9. 其他补充

仓库提供 CODE_OF_CONDUCT、CONTRIBUTING、SECURITY.md 等标准开源治理文件，SECURITY.md 明确了漏洞报告邮箱与响应流程。README 提供韩语版本（README-KR.md），wiki 有独立的多页文档站。

10. 安装使用方式

推荐方式（一条命令，自动适配 Claude Code / Codex / Cursor / Amp / Gemini CLI 等多个 agent）：

npx skills add bitjaru/styleseed

安装后需在 Claude Code 中运行 /ss-setup，或在 Codex 中运行 $ss-setup（也可从 Codex 的 /skills 选择器中选取），触发交互式设置向导（选择 App 类型、品牌色或预设皮肤、字体偏好），随后自动生成第一个页面。

手动方式：

git clone https://github.com/bitjaru/styleseed.git /tmp/styleseed
mkdir -p .claude/skills && cp -r /tmp/styleseed/engine/.claude/skills/* .claude/skills/   # Claude Code
mkdir -p .agents/skills && cp -r /tmp/styleseed/engine/.claude/skills/* .agents/skills/    # Codex

注意事项：需要本机安装 Node.js 以运行 npx；安装后建议开启一个新的 agent 会话再触发 /ss-setup，避免技能发现缓存导致检测不到新命令。

11. 注意事项

需要 Node.js 环境支持 npx，无 Node 环境用户需先自行安装
官方文档未提及 OpenClaw、Hermes Agent 的兼容情况，实际效果未验证
品牌“皮肤”目前主要体现在配色与圆角层面，并非对 Toss、Vercel 等品牌完整设计系统的忠实复刻，使用前应有合理预期
如遇到技能未被 agent 识别，官方建议重新开启一个新会话