用途:作为 Open Design 的原子操作底座,只执行可验证操作,不替客户决定视觉方向、叙事或模板取舍。上层设计流程可调用它管理 daemon、目录、设计系统与导出能力。
主要能力:检查 Node、pnpm、checkout 并控制本地 daemon、探测 /api/skills;区分正式三件套(manifest.json、DESIGN.md、tokens.css)与 DESIGN.md-only 兼容路径并接入设计系统;分开查询 functional skills 与 rendering templates;按上游稳定入口导出 HTML、PDF、PPTX、MP4;复用 daemon 保存的原生 session handle 继续会话。
使用方式:安装技能用 npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-open-design-ops -y。上游前置为 Node.js 24.x、pnpm 10.33.x 与 Corepack,按 QUICKSTART.md 克隆并安装。环境检查运行 python3 scripts/check_env.py;daemon 用 python3 scripts/daemon_ctl.py start/status/health/stop,健康以 GET /api/skills 返回数组为准,默认 http://127.0.0.1:7456,仅允许 loopback。目录查询用 python3 scripts/list_skills.py(可加 --category)。导出示例:node <open-design-root>/apps/daemon/dist/cli.js export <project-file.html> --project <project-id> --format pdf --out <output.pdf>;PPTX 内置为一页一张截图,可编辑 PPTX 需配合 pptx-generator 与 pptx-html-fidelity-audit。MP4 用 media generate --surface video --model hyperframes-html。resume 由 daemon 自动完成,非手工 od resume。
限制:不安装或内嵌 Open Design;Node/pnpm/checkout 缺失时停止需 daemon 的流程。不臆造 headless API,不直接 POST 未文档化 payload。不打印 config、env 或凭据;删除、覆盖、rename 前需明确授权。远端部署、反向代理或 0.0.0.0 需客户按上游安全配置处理。凭据与本机路径只进私有 config 或进程环境。