soia-dev-open-design-opslisted
Install: claude install-skill soia-team/soia-open-skills
# soia-dev-open-design-ops — Open Design 原子操作层
只执行可验证的 Open Design 原子操作,不替客户做视觉方向、叙事或模板取舍。上层设计流程可把本技能作为 daemon、目录、设计系统与导出能力的底座。
## 客户可读说明
### 这个技能可以做什么
| 客户想要 | 技能会做 | 客户能看到 |
|---|---|---|
| 检查或启动 Open Design | 检查 Node、pnpm、checkout,控制本地 daemon 并探测 `/api/skills` | JSON 状态、缺失项、日志位置与修复命令 |
| 接入设计系统 | 区分正式三件套与 `DESIGN.md`-only 兼容路径,再用上游 CLI/App 接入 | 设计系统 id、来源、验证结果 |
| 查询能力目录 | 分开查询 functional skills 与 rendering templates | 名称、说明、`od.mode`/category 清单 |
| 渲染和导出 | 按上游稳定入口驱动 App/CLI,导出 HTML、PDF、PPTX 或 MP4 | 产物路径、格式语义、可打开性检查 |
| 继续已有设计会话 | 复用 daemon 保存的原生 session handle | 同一会话的 follow-up 结果或明确降级原因 |
### 客户如何使用
1. 说明目标:环境检查、daemon、设计系统、目录查询、渲染/导出或继续会话。
2. 提供 Open Design checkout 路径;设计系统接入时再提供项目路径或 `DESIGN.md`。
3. 导出时提供 project id、项目内源文件、目标格式与输出路径;PPTX 还要说明“像素保真”还是“可编辑”。
4. Agent 先运行只读检查,再执行最小原子命令;覆盖文件、删除系统或写远端前必须单独确认。
5. 执行后检查真实 API 响应或产物,不以命令退出码代替验收。
### 依赖与安装
安装本技能:
```bash
npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-open-design-ops -y
```
Open Design 本地开发 checkout 的上游前置为 Node.js 24.x、pnpm 10.33.x 与 Corepack。按 upstream `QUICKSTART.md`:
```bash
git clone https://github.com/nexu-io/open-design.git <open-design-root>
cd <open-design-root>
corepack enable
corepack pnpm --version # upstream 当前 pin 10.33.2
pnpm install
```
本技能不安装或内嵌 Open Design,也不把 Open Design 当作另一个 agent skill。Node/pnpm/checkout 任一缺失时,停止需要 daemon 的 workflow,并返回补齐命令。
### 私有配置
复制 `config.example.yml` 到:
```text
~/.config/soia-skills/soia-open-skills/soia-dev/soia-dev-open-design-ops/