Design Judge Skills

面向设计奖全流程的证据驱动 Agent Skills：从获奖案例检索、设计评价和奖项匹配，到申报文字准备与提交终检。

快速开始 · 获奖样本体量 · 安装 · 技能索引 · 贡献与开发 · English

design-judge-skills 将设计奖申报拆解为边界清晰、可独立触发与验证的技能模块，围绕官方来源、证据定位与透明评分构建可追溯的辅助决策流程，并依据公开标准比较申报路径、解释适配度与确定申报优先级。

目录

• 1. 项目介绍
• 2. 工作流
• 3. 设计原则与边界
• 4. 快速开始
• 5. 安装
  • 5.1 npx skills 安装方式
  • 5.2 Claude Code 安装方式
  • 5.3 Codex 安装方式
  • 5.4 其他 Agent 场景
• 6. 技能索引
• 7. 贡献与开发

1. 项目介绍

Design Judge Skills 覆盖设计奖申报中的五类核心任务：

• 检索并核验同类别获奖案例；
• 用证据化量表评价设计本体与展示表达；
• 匹配奖项、项目路径和申报类别；
• 从用户材料中准备有来源约束的申报文字；
• 按当届官方规则检查提交包是否就绪。

当前配置覆盖 iF DESIGN AWARD、iF DESIGN STUDENT AWARD、Red Dot Product Design、Red Dot Design Concept、IDEA、DIA、K-Design、GOOD DESIGN AWARD Japan、Core77、James Dyson 和 EPDA。涉及截止日期、费用、资格、类别与提交规格时，技能要求在运行时重新核验官方页面。

评价模块内置来自 iF、iF Student、Red Dot 与 IDEA 的 22,125 条获奖或入围作品聚合观察记录。这些数据只提供描述性背景，不改变核心评分，也不能用于估计获奖概率。参见覆盖范围、隐私与限制。

2. 工作流

设计材料 ── 不确定路线或需要完整流程 ──> design-award-pipeline
  │
  ├─ 寻找同类获奖案例 ──────────────> design-award-search
  ├─ 评价设计与展示表达 ────────────> design-evaluation
  └─ 选择奖项 / 赛道 / 类别 ───────> design-award-match
                                         │
                                         v
                                design-information-prep
                                         │
                                         v
                                design-submission-check

这些模块可以独立使用。完整申报流程通常从评价或匹配开始，在目标奖项确定后进入信息准备，最后执行提交终检。

3. 设计原则与边界

1. 优先使用一手来源。 奖项规则和案例以官方页面为准，搜索摘要与第三方页面只能用于发现线索。
2. 事实与推断分离。 用户材料中的事实、模型推断和待用户确认项必须分别标记。
3. 评分保持透明。 适配度和评价分数用于辅助决策，不代表获奖概率。
4. 模块职责单一。 检索、评价、奖项匹配、文字准备和提交检查不互相越界。
5. 不冒充官方判断。 可对齐公开评审标准，但不模拟未公开的评委偏好或内部流程。

4. 快速开始

安装完成后，直接把设计图片、展板、说明书、项目 brief、研究材料或申报文件交给 Agent，并说明任务。下面的提示词可以直接复制。

如果不确定该用哪个技能，使用 design-award-pipeline；它只选择必要模块，不会强制执行完整流水线。

5. 安装

仓库中的每个 skills/<name>/ 目录都是一个可安装单元。design-judge-shared 是共享支持包；全量安装时会自动包含，单独安装 design-award-search 或 design-award-match 时请同时安装它。

5.1 npx skills 安装方式

需要 Node.js 18 或更高版本。无需全局安装 CLI。

先查看仓库中可安装的技能：

npx skills add SeanJ1ang/design-judge-skills --list

把全部技能全局安装到 Codex：

npx skills add SeanJ1ang/design-judge-skills --global --agent codex --skill '*' --yes --copy

只为当前项目安装一个独立技能：

npx skills add SeanJ1ang/design-judge-skills --agent codex --skill design-evaluation --yes --copy

单独安装依赖共享资料的技能：

npx skills add SeanJ1ang/design-judge-skills --global --agent codex \
  --skill design-award-search --skill design-judge-shared --yes --copy

安装到 CLI 支持的所有 Agent：

npx skills add SeanJ1ang/design-judge-skills --all

检查与更新：

npx skills list --global --agent codex
npx skills update --global --yes

5.2 Claude Code 安装方式

全量安装：

npx skills add SeanJ1ang/design-judge-skills --global --agent claude-code --skill '*' --yes --copy

安装后开启新的 Claude Code 会话，自然描述任务或明确指定技能名，例如：

Use $design-award-match to compare the best award routes for this student concept.

5.3 Codex 安装方式

推荐使用 npx skills 安装到 Codex 的全局技能目录：

npx skills add SeanJ1ang/design-judge-skills --global --agent codex --skill '*' --yes --copy

也可以把仓库链接直接交给 Codex：

请从 https://github.com/SeanJ1ang/design-judge-skills 安装全部 Codex skills。
请保留每个技能的完整目录，并同时安装 design-judge-shared。
安装完成后检查所有 SKILL.md 的 frontmatter。

安装或更新后请开启一个新的 Codex 会话，使技能列表完整刷新。

5.4 其他 Agent 场景

对 OpenClaw、OpenCode、Hermes Agent、Cursor、Cline、Gemini CLI 等受 npx skills 支持的 Agent，可以使用相应的 --agent 标识：

npx skills add SeanJ1ang/design-judge-skills --global --skill '*' --yes --copy \
  --agent openclaw --agent opencode --agent hermes-agent

也可以直接安装到 CLI 支持的全部 Agent：

npx skills add SeanJ1ang/design-judge-skills --all

对于其他兼容 SKILL.md 的 Agent：

1. clone 本仓库到稳定路径；
2. 将完整技能目录复制或链接到该 Agent 的技能目录；
3. 保留 SKILL.md、agents/、references/、scripts/、examples/ 和 tests/；
4. 使用 design-award-search 或 design-award-match 时，同时保留 design-judge-shared。

6. 技能索引

状态含义：Beta 表示已通过示例与自动化测试但仍可能存在边界问题；Stable 表示工作流和规则相对稳定；Support 表示仅作为其他技能的安装依赖。徽章统计六个面向用户的工作流，不包含共享支持包。

7. 贡献与开发

7.1 目录结构

skills/
├── design-judge-shared/
│   ├── SKILL.md
│   ├── category-taxonomy.md
│   └── source-registry.md
└── design-<topic>/
    ├── SKILL.md
    ├── README.md
    ├── README_EN.md
    ├── agents/openai.yaml
    ├── references/
    ├── scripts/
    ├── examples/
    └── tests/

7.2 开发约定

• 技能目录名与 frontmatter 中的 name 保持一致，只使用小写字母、数字和连字符。
• description 同时说明技能做什么、何时触发和不适用范围。
• 核心工作流保留在 SKILL.md，长规则、规范和数据结构放入 references/。
• 超过 100 行的 Markdown 参考资料需在文件顶部提供目录，便于按需加载。
• 可重复且需要确定性的操作写成 scripts/，并提供对应测试。
• 每个面向用户的技能提供章节镜像的中英文详情页，说明输入、产出、边界和相关技能。
• 每个技能都要维护 agents/openai.yaml；共享支持包必须关闭隐式调用。
• 当前年份、截止日期、费用、资格和提交规格不得作为长期稳定事实写死；运行时从官方来源核验。
• GitHub Actions 的第三方步骤使用完整提交 SHA 固定版本，降低供应链漂移风险。
• 不提交 API key、cookie、登录态、用户项目材料、私有获奖数据库或受版权保护的完整案例内容。

7.3 新增或修改技能

1. 在 skills/design-<topic>/ 创建或修改完整技能目录。
2. 编写有效的 SKILL.md frontmatter 与简洁工作流。
3. 添加必要的 agents/openai.yaml、参考资料、脚本、示例和测试。
4. 更新本 README 的技能索引、状态和依赖说明。
5. 在提交前运行对应技能的单元测试与基础校验。

运行仓库工具回归测试和全部技能单元测试：

python -B -m unittest discover -s tools/tests -p 'test_*.py' -v
Get-ChildItem skills -Directory | ForEach-Object {
  if (Test-Path (Join-Path $_.FullName 'tests')) {
    Push-Location $_.FullName
    python -B -m unittest discover -s tests -p 'test_*.py' -v
    Pop-Location
  }
}

提交前还应运行：

python tools/validate_repository.py
python tools/generate_benchmark_coverage.py --check
git diff --check
npx skills add . --list

欢迎通过 Issue 报告规则变更、错误案例或兼容性问题，也欢迎通过 Pull Request 提交新的奖项配置、测试和工作流改进。请在 PR 中说明证据来源、验证方法和可能影响的技能。