技能设计师（Skill Designer）
概述
从结构化的技能创意规范生成一个全面的 Claude CLI 提示。该提示指导 Claude 按照仓库约定创建一个完整的技能目录：包含带 YAML 前置元数据的 SKILL.md、参考文档、辅助脚本和测试框架。
何时使用
- 技能自动生成管道从待办事项中选择了一个创意，需要生成一个供
claude -p使用的设计提示 - 开发者想要根据 JSON 创意规范快速搭建一个新技能
- 需要对生成的技能进行质量审查，需要了解评分标准
前提条件
- Python 3.9+
- 无需外部 API 密钥
- 参考文件必须存在于
references/目录下
工作流程
第一步：准备创意规范
接受一个 JSON 文件（--idea-json），包含：
title：人类可读的技能创意名称description：技能的功能描述category：技能类别（例如：交易分析、开发者工具）
接受一个规范化技能名称（--skill-name），它将用作目录名和 YAML 前置元数据中的 name: 字段。
第二步：构建设计提示
运行提示构建器：
python3 skills/skill-designer/scripts/build_design_prompt.py \
--idea-json /tmp/idea.json \
--skill-name "my-new-skill" \
--project-root .
该脚本：
- 加载创意 JSON
- 读取所有三个参考文件（结构指南、质量检查清单、模板）
- 列出已有技能（最多 20 个）以避免重复
- 将完整的提示输出到标准输出
第三步：将提示输入到 Claude CLI
调用管道将提示通过管道传入 claude -p：
python3 skills/skill-designer/scripts/build_design_prompt.py \
--idea-json /tmp/idea.json \
--skill-name "my-new-skill" \
--project-root . \
| claude -p --allowedTools Read,Edit,Write,Glob,Grep
第四步：验证输出
在 Claude 创建技能后，验证：
skills/<skill-name>/SKILL.md存在且包含正确的前置元数据- 目录结构符合约定
- 使用双轴技能审查器（dual-axis-skill-reviewer）的评分达到阈值
输出格式
脚本以纯文本形式将提示输出到标准输出。成功时退出码为 0，如果所需的参考文件缺失则退出码为 1。
资源
references/skill-structure-guide.md— 目录结构、SKILL.md 格式、命名约定references/quality-checklist.md— 双轴审查器 5 大类检查清单（100 分）references/skill-template.md— 带 YAML 前置元数据和标准章节的 SKILL.md 模板scripts/build_design_prompt.py— 提示构建器脚本（CLI 接口）