用途
designcraft-cli 是 DesignCraft 的原生命令行技能，主要用于用户明确要求查看 DesignCraft 原生命令、查询参数、检查命令计划或执行单项计划时提供受控入口。该技能从固定摘要制品安装原生 CLI，并保留源素材与可编辑工程。
主要能力
- 提供完整原生 CLI 的候选实现，可用于查询命令目录、描述参数与检查命令计划。
- 首次使用时从固定摘要制品安装原生 CLI，保留源素材与可编辑工程。
- 区分只读查询与可能安装/写入的命令，完整文档目标转交 designcraft-use，纯安装问题转交 designcraft-cli-setup。
- 只读核对固定 CLI 版本与当前命令目录，目录缺失或版本不符时阻止依赖该能力的写操作。
- 用真实 schema 检查命令与参数，并登记需保全的输入。
- 核实输出路径与用户范围授权后受控执行一次计划，保存原始 stdout/stderr、回执与身份摘要。
- 按产物契约检查文件与工程重开状态。
使用方式
首次使用时，将 SKILL_DIR 设置为宿主实际加载的本 SKILL.md 所在绝对目录。技能可独立安装到项目 .agents/skills、用户技能目录或插件缓存。用户请求已授权必要依赖时，公开 cli.py 自动校验并安装固定原生版本到用户数据目录，不使用 sudo，不修改 PATH。示例：
: "${SKILL_DIR:?设置为本技能真实加载目录}"
python3 -I -B "$SKILL_DIR/scripts/cli.py" -- commands
需要只检查安装时：
python3 -I -B "$SKILL_DIR/scripts/bootstrap.py"
python3 -I -B "$SKILL_DIR/scripts/cli.py" -- --version
--runtime-home 或 CRAFT_RUNTIME_HOME 指定隔离运行时目录，放在 -- 之前。--archive 指向已有固定 ZIP，仍校验归档与二进制摘要。安装失败返回 dependencySetup，不自动重试编辑或渲染；校验失败保留已有目录。
适用场景
- 用户明确要求查看 DesignCraft 原生命令、查询参数。
- 用户要求检查命令计划或执行单项计划。
- 需要查询命令目录和描述参数，且不修改工程。
完整排版成果的请求应交给 designcraft-use；单独安装诊断应交给 designcraft-cli-setup。
限制
- 当前为候选实现，尚未完成实际宿主、原生安装与创作验收。
- 仅支持 macOS arm64、Python 3.11+。
- 不使用研究源码、缓存或离线 catalog 执行原生写操作；写入必须使用固定版本的真实命令目录。
- run 可安装运行时并修改本地文件，必须分别核实安装授权、输入、输出和计划范围。
- 脚本以当前用户权限运行；--input 未登记的路径不在摘要保护范围内。
- 不把计划结构校验、进程退出码或回执存在说成业务完成。
- 真实目录缺失不等于命令不存在：可以只读报告缺少证据，不能猜测后写入。
- 零退出可能包含业务警告：检查原始问题和产物内容。
- UNKNOWN 不能自动重试：先核对进程、回执和已有副作用。
- 单会话不能证明步骤级完成：无逐步回执时保留批次级状态。
- 安装成功不是模型或业务验收：分层报告各项状态。
- 当前锁仅固定原生 CLI，发布快照与宿主自动发现仍须另行验证。
- 交换格式损失需单独记录。