Skill · Portfolio
디자인 포트폴리오 구성·첨삭
리서치·스케치·렌더·시제품 자료로 근거 있는 가로형 포트폴리오를 구성하고 첨삭하는 원작 스킬(산업디자인). 원작자 truman-t3, MIT.
0installs
industrial-design-portfolio/README.zh-CN.md
<div align="center"># 工业设计作品集 Skill### 把产品设计证据，整理成真正能够证明判断力的作品集。简体中文 · [English](README.md)[](https://github.com/truman-t3/industrial-design-portfolio-skill/actions/workflows/validate.yml)[](https://truman-t3.github.io/industrial-design-portfolio-skill/)</div>如果你的项目文件夹里已经有调研笔记、草图、CAD 截图、效果图、模型照片或测试记录，就可以开始。把这个文件夹交给 Agent，这个 Skill 会帮助它：1. 从你真正做过的工作里找出最值得讲的故事；2. 说明设计选择、备选方案、取舍和你的个人职责；3. 找出仍然缺少证明的重要结论；4. 整理成可编辑的 HTML 作品集，并可打印为 PDF。它不会为了“让项目看起来完整”而虚构调研、原型、测试、制造决策或项目成果。## 看看最终效果**模块化桌面工作灯**是一套虚构的 14 页案例，展示零散资料如何变成清楚的设计故事，同时如实标注假设和 AI 辅助图像。| 开始时有什么 | Skill 会做什么 | 最终得到什么 ||---|---|---|| 任务书、草图、过程记录、CAD/效果图、原型或测试资料 | 找故事 → 检查依据 → 规划页面 → 制作并审查 | 14 页响应式 HTML 作品集 |[在线打开 14 页 Showcase](https://truman-t3.github.io/industrial-design-portfolio-skill/) · [查看 HTML 源文件](showcase/modular-desk-lamp/index.html) · [阅读故事板](showcase/modular-desk-lamp/storyboard.md) · [检查证据 manifest](showcase/modular-desk-lamp/portfolio_manifest.json)> **虚构演示声明：** AI 辅助图像只用于表达设计意图，不是用户调研、实体原型、CAD、测试结果或工程证明。检查完整案例链路：[起始任务书](showcase/modular-desk-lamp/input/brief.md) → [素材清单](showcase/modular-desk-lamp/input/asset-inventory.json) → [前置追问](showcase/modular-desk-lamp/input/gating-questions.md) → [复现提示词](showcase/modular-desk-lamp/input/reproduction-prompt.md) → [输入到输出记录](showcase/modular-desk-lamp/input-to-output-trace.md)这套工作流改善了案例的结构和披露方式，但没有把虚构的 E0 材料变成真实证据。下一项关键证明仍然是一轮经过脱敏的真实项目前向测试。### 四套视觉系统 × 七种标志性构图 × 18 种页面结构上图展示了 28 个可直接复制的 HTML 构图片段中的三种代表性页面，不是 AI 模拟效果。每套系统现在都覆盖封面、证据、CMF、产品架构、迭代、最终方案和项目分隔页。证据字段与版式 ID 保持不变，但页面骨架、信息层级、比例、图片角色、留白、网格、字体和颜色会一起变化；其余页面继续使用共享的 18 种版式库。| 视觉系统 | 当你最希望评审先相信…… | 构图特征 ||---|---|---|| **Workshop / 工坊** · `workshop-orange` | 动手过程、方案探索和能力广度 | 错位面板、交错证据、活跃的过程标记 || **Instrument / 仪器** · `instrument-blue` | 结构、CAD、参数和测试 | 严格对齐、技术单元、紧凑元数据 || **Material / 材质** · `material-green` | CMF、触感、生活情境和健康体验 | 非对称图片主导、柔和图框、舒缓节奏 || **Gallery / 展陈** · `gallery-red` | 造型、工艺、最终摄影和文化表达 | 单一主视觉、极端比例对比、编辑式留白 |不知道选哪套也没关系。把项目资料交给 Agent，它会根据最强证据和目标受众推荐一套预设，用一句话说明理由，并在整份作品集中保持一致。混合型作品集默认使用“工坊”。## 30 秒开始不需要懂终端。把下面这段话直接发给 Codex，或其他能够安装 Skill 的 Agent：```text请为当前用户安装下面仓库中的 industrial-design-portfolio：https://github.com/truman-t3/industrial-design-portfolio-skill安装完成后请确认，并告诉我是否需要新建一个会话。```也可以使用这一条跨终端命令：```bashnpx skills add truman-t3/industrial-design-portfolio-skill --global --skill industrial-design-portfolio --yes --copy```然后把项目文件夹交给 Agent，并发送：```text使用 $industrial-design-portfolio，根据这些资料制作一套 14 页工业设计案例。如果我没有指定视觉风格，请根据证据和目标受众推荐最合适的预设，并用一句话说明理由。所有仍然缺少证据的内容都要明确标注。```## 选择你现在需要的帮助| 你的情况 | 可以让 Skill 做什么 ||---|---|| 手上是一个混乱的项目文件夹 | 整理成一套清楚的 12–18 页项目案例 || 已经有一份作品集 | 审查哪些内容该删、该换顺序、该解释或补证据 || 项目太多，不知道选哪些 | 根据职位、学校或目标受众选择项目 || 设计过程不完整 | 区分已有证明、个人回忆、假设和待验证内容 |## 它会怎样帮助你- **找到故事**：明确项目问题、关键转折和最终设计决定。- **展示判断力**：说明为什么选择这个方向，以及反馈或测试后改了什么。- **写清个人职责**：区分你完成的工作、团队协作和外部提供的素材。- **选择合适页面**：使用 18 种工业设计版式组织调研、方案、CMF、结构、制造、测试、迭代和最终成果。- **选择视觉表达**：从四套风格预设中选择一套，同时保持底层证据结构不变。- **保持诚实**：把假设和 AI 辅助概念图明确标出来，不冒充真实调研或工程证明。- **完成可用作品**：生成适合网页浏览、面试讲解和 PDF 导出的响应式作品集。## 从项目文件夹到作品集```mermaidflowchart LR A[收集项目资料] --> B[找到最强故事] B --> C[标出缺口和假设] C --> D[规划页面] D --> E[制作并审查] E --> F[分享 HTML 或导出 PDF]```在这些简单步骤背后，Skill 会检查评审最可能提出的五个问题：| 评审可能会问 | 作品集需要说清什么 ||---|---|| 你是否理解了真实需求？ | 情境来自观察或已有资料，而不是事后编造 || 为什么产品要这样造型和使用材料？ | 造型、CMF 和人体工学选择服务于明确目标 || 产品作为系统能否成立？ | 零件、接口、装配和维修路径合理 || 可行性结论是否可信？ | 制造和成本说法公开其假设条件 || 你学到了什么，又改了什么？ | 备选方案、取舍、反馈、测试和迭代清晰可见 |## 你会得到什么```textportfolio/├── index.html # 可编辑的响应式作品集├── images/ # 调研、草图、CAD、原型和最终方案├── portfolio_manifest.json # 记录职责、证据和待解决问题，供 Agent 检查└── source_notes.md # 来源、署名、AI 披露和缺失证据```大多数设计师只需要打开 `index.html` 并整理 `images` 文件夹。另外两个文件用来帮助 Agent 保持结论、署名和缺失证据前后一致。作品集支持键盘、滚轮、触屏、减少动效模式以及打印/PDF 导出。## 安装选择一种方式即可。大多数设计师只需要方式 A 或 B。### 方式 A：直接让 Agent 安装不需要自己输入终端命令。把下面这段话发送给 Codex，或其他能够安装 Skill 的 Agent：```text请为当前用户安装下面仓库中的 industrial-design-portfolio：https://github.com/truman-t3/industrial-design-portfolio-skill安装后请确认 Skill 名称是 industrial-design-portfolio，并告诉我是否需要新建一个会话。```### 方式 B：使用 Skills CLI这种方式需要 [Node.js 18 或更高版本](https://nodejs.org/)，不需要提前全局安装 CLI。先确认仓库可以被识别：```bashnpx skills add truman-t3/industrial-design-portfolio-skill --list```为 Codex 全局安装：```bashnpx skills add truman-t3/industrial-design-portfolio-skill --global --agent codex --skill industrial-design-portfolio --yes --copy```如果使用 Claude Code，把 `codex` 换成 `claude-code`。也可以让 CLI 交互选择支持的 Agent：```bashnpx skills add truman-t3/industrial-design-portfolio-skill --all```检查安装或更新已经安装的 Skill：```bashnpx skills list --global --agent codexnpx skills update --global --yes```安装或更新后，请新建一个 Agent 会话，让技能列表完整刷新。### 方式 C：克隆并使用内置安装器如果需要明确指定安装位置，或者不使用 Node.js，可以使用这种方式：```bashgit clone https://github.com/truman-t3/industrial-design-portfolio-skill.gitcd industrial-design-portfolio-skill# 根据你的 Agent 选择一项python scripts/install_skill.py --platform codex --scope userpython scripts/install_skill.py --platform claude --scope userpython scripts/install_skill.py --platform cursor --scope userpython scripts/install_skill.py --platform gemini --scope userpython scripts/install_skill.py --platform opencode --scope user```安装到当前项目的 Agent 通用目录：```bashpython scripts/install_skill.py --platform agents --scope project```如果系统使用 `python3`，请将以上命令中的 `python` 替换为 `python3`。## 使用示例```text使用 $industrial-design-portfolio，把我的调研记录、草图、CAD 截图和模型照片整理成一个 14 页的工业设计项目案例。``````text按照初级工业设计师求职标准评审我的 28 页作品集。告诉我应该删什么、缺少什么证据，并重新规划页面顺序。``````text从我的六个项目中选择三个，制作高级产品设计师求职作品集。重点体现个人职责、制造协作和经过验证的设计迭代。``````text请根据这个项目的主要证据和目标受众推荐最合适的视觉预设。先用一句话解释选择，再开始制作案例。``````text请使用 Gallery / 展陈预设制作这个家具项目案例。保持证据规则不变，用更充分的留白呈现造型、工艺和最终摄影。```## 证据，而不是表演Skill 使用四级证据体系：| 等级 | 含义 | 作品集处理方式 ||---|---|---|| E0 | 没有支持材料的想法或模型建议 | 标记为“假设” || E1 | 用户提供但尚未核实的内容 | 标注来源和限制 || E2 | 直接项目证据 | 附带作者、情境和说明 || E3 | 可以独立验证的结果 | 标注来源和日期 |视觉精致程度不会提高证据等级。AI 生成的爆炸图只能称为“概念结构示意图”，不能冒充可以制造的工程图。## 跨 Agent 架构`SKILL.md` 是唯一规范源，其他平台入口均由它生成：```textSKILL.md # Agent Skills 标准主文件├── AGENTS.md # Agent 通用持久指令入口├── CLAUDE.md # Claude Code 入口├── GEMINI.md # Gemini CLI 入口├── agents/openai.yaml # Codex UI 元数据├── assets/ # 原创 HTML 作品集模板├── references/ # 叙事、证据、版式、视觉、质检├── scripts/ # 安装、同步、验证├── schemas/ # portfolio manifest 契约└── evals/ # 跨平台 rubric 与 fixture 观察结果```修改 `SKILL.md` 后重新生成并检查适配文件：```bashpython scripts/sync_adapters.pypython scripts/sync_adapters.py --check```## 作品集验证```bashpython scripts/validate_manifest.py path/to/portfolio/portfolio_manifest.jsonpython scripts/validate_portfolio.py path/to/portfolio/index.htmlpython scripts/validate_layout_library.pypython scripts/run_evals.py --allpython -m pip install --requirement requirements-test.txtpython -m unittest discover -s tests -p "test_*.py" -vnpm cinpx playwright install chromiumnpm run test:browser````run_evals.py` 会把结构化评估观察结果与六条 rubric 对照；它不会声称自己执行了模型。Python 测试会检查 schema、六平台安装矩阵、版本一致性和轻量模板契约；Playwright 会检查 Showcase 导航、延迟挂载、移动端布局和完整渲染导出行为。P0 可信度问题和 P1 理解/可用性问题会阻止交付；P2、P3 作为设计完善建议报告。## 设计原则1. 展示设计决策，而不是流水账。2. 优先保留真实材料，再考虑生成图像。3. 区分设计意图与工程证明。4. 团队项目必须写清个人职责。5. 让版式适配证据形态，而不是为了丰富而变化。6. 每个项目以最终方案和反思结束，而不是停在一张没有解释的效果图。## 项目思想来源这是一个原创实现，工作方法受到以下开源项目启发：- [`michaelboeding/skills`](https://github.com/michaelboeding/skills/tree/master/skills/product-engineer-agent)：产品开发的多视角分析。- [`op7418/guizang-ppt-skill`](https://github.com/op7418/guizang-ppt-skill)：叙事节奏、版式约束、图片槽位和分级质检。- [`truman-t3/shijing-skill`](https://github.com/truman-t3/shijing-skill)：单一规范源、跨 Agent 适配、安装与 eval。本项目没有复制 `guizang-ppt-skill` 的模板或源代码。## 版本当前正式版本：**v1.3.0**- 以证据为核心的工业设计作品集工作流- MIT 许可证，明确可复用范围- 可校验证据、作者职责、AI 披露与版式的 manifest- 原创响应式 HTML 横向作品集模板- 18 种工业设计专用登记版式- 公开的虚构输入包、前置追问、复现提示词与输入到输出记录- 跨 Agent 入口与安装器- 经 UTF-8 检查的 Codex 界面元数据- HTML/manifest 验证器与六条可执行行为 rubric- 跨平台 Python 测试与 Chromium 浏览器行为测试