关于 building-design
此技能指导 building-design 的初始化与设计工作流,包括确定设计根目录并遵循项目约定和配方,适用于按指定结构创建或修改设计。
主要功能
- 01设置设计根目录与查看器
- 02安装查看器依赖
- 03阅读设计与预览约定
- 04按意图选择配方
适用场景
- 01检查 building-design 是否就绪
- 02为功能创建设计
- 03修改现有设计
- 04根据 .design.ts 文件开展工作
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cedmandocdoc/ awesome-skills --skill building-design安装后在 Claude Code 中输入/building-design确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlassets/design.mdindex.mdassets/app/.gitignoreindex.htmlpackage.jsontsconfig.jsonvite.config.tsassets/app/system/define.tsmotion.cssmotion.tstype.cssassets/app/viewer/App.tsxcanvas.tsxchrome.tsxframe.cssFrame.tsxmain.tsxmeta.tsregistry.tsviewer.cssassets/surface/feature/feature.design.tsscreen.cssscreen.design.tsScreen.tsxassets/surface/ui/component.csscomponent.design.tsComponent.tsxreferences/creating-design.mddesign-contract.md详细介绍
构建设计
设置
| 项目 | 类型 | 必需 | 适用时机 | 完成条件 | 方法 |
|---|---|---|---|---|---|
| Node.js 22.12+ 和 npm | 用户 | 必需 | 全部 | node --version 显示 22.12 或更高版本 | https://nodejs.org |
| 根路径和意图 | 询问 | 必需 | 全部 | design-contract.md → 解析设计根目录 为请求的意图找到根目录 | 询问文件夹(默认值见 design-contract.md → 设计根目录)和意图(一句简短表述);若缺失或为空,则使用默认值;否则询问其他路径;将其记录为根目录的位置和 index.md → intention |
| 根目录标记 | 静态 | 必需 | 全部 | <design-root>/index.md 包含 design-contract.md → 作者签名 | 使用 assets/index.md 编写 index.md,并填入 intention |
| 查看器应用 | 静态 | 必需 | 全部 | 查看器文件和 index.md → 查看器键与 assets/ 一致 | 复制 assets/app/ 中的所有内容,包括点文件(cp -R <skill>/assets/app/. <design-root>/);用 assets/index.md 替换 index.md → 查看器键 |
| 查看器安装 | 自动 | 必需 | 全部 | <design-root>/node_modules/ 存在 | 在设计根目录中运行 npm install |
工作流
- 设置 — 按顺序处理 设置中适用时机涵盖此请求的每一行:满足完成条件 → 跳过;
user→ 若为必需,则停止并输出其方法;若为可选,则不执行并继续;ask→ 填入请求中已回答的内容,将其余问题合并为一条消息询问,并记录每个答案;auto和static→ 执行。 - 契约 — 阅读 design-contract.md 和 preview-contract.md。
- 配方 — 匹配 配方中的一行;打开其“阅读”列中的每份文档。
配方
| 意图 | 示例措辞 | 阅读 |
|---|---|---|
| 设置 | “设置 building-design”,“building-design 已准备就绪吗?” | 设置 — 对每一行执行工作流第 1 步,然后报告每一行的状态 |
| 构建或修改 | “设计结账功能”,“缩短主视觉标题”,提及 @design/design.md 或 .design.ts 文件 | creating-design.md |
评论
支持 Markdown