用途:定义 catalog-publisher 发布设计包目录时遵循的方法,产出 GitHub 公开仓库与 Next.js 目录网站。
仓库布局:README.md(项目目的、用法、目录概览)、CONTRIBUTING.md(新增包流程与 schema 链接)、LICENSE、catalog.json(机器可读索引)、design-packs/{slug}/(含 prompt.md、tokens.json、preview.png、meta.yaml)、site/(Next.js 目录应用)。
README 需让访客 30 秒内了解:为何需要该目录、设计包是什么及数量、如何使用(复制包的 prompt.md 粘贴到 Claude Code 并请求按该风格生成)、贡献与许可。
许可与版权:LICENSE 适用于本仓库发布的设计规范、令牌与文档,推荐 MIT 或 CC BY 4.0;须声明各包为公开设计系统视觉原理的规范,不重新分发特定产品的商标、标识或专有资产,来源写入 meta.yaml;license: unclear 的包发布前需与 pack-architect 厘清。
网站规格:Next.js 15 App Router + TypeScript,构建期从 catalog.json 与 design-packs/ 静态生成,无运行时数据库。核心动线是复制:浏览包网格、按轨道(PPT/网页)与风格轴筛选、在详情页一键复制 prompt.md,复制按钮最显眼。卡片含 preview.png 缩略图、display_name、轨道徽章、轴标签;production 目录仅纳入 publishable 包,未通过者不打徽章展示。详情页含大图预览、prompt.md 全文与复制按钮、tokens.json 可视化、meta.yaml 来源。站点自身需有克制排版与清晰网格,保持中立风格,响应式,深色模式可选。
部署:在 site/ 执行 npm run build 通过后发布 Vercel 预览并取得 URL,自测通过后向用户报告;只有用户明确批准后才做 production 部署,GitHub 公开也需用户指定并批准远程仓库。
发布门禁:status 不手写,由门禁结果生成;publishable 定义与所需门禁见 design-pack-schema,避免复制;仅 status: pass 的包进入 production 目录;needs_review、reject 包不导出为 draft 徽章,失败包不得公开;缺少 fidelity_qa/、craft_qa/、render-manifest.json 等门禁产物时构建失败;废弃此前“两次驳回后升级并以 draft 徽章发布”的规则。
自测清单:构建成功无控制台错误;所有卡片渲染且预览图不破;轨道与轴筛选可用;复制按钮真实写入剪贴板;375px 宽不破版;catalog.json 包数等于 design-packs/ 文件夹数;production 数据不含 needs_review 与 reject 包。
重跑:已有 site/ 与仓库时增量更新而非全量重建;仅要求“重新部署”时只做构建与部署。
限制:资料未提供具体命令细节、Vercel 配置、定价等信息。