mcpField
S
skill-designer

skill-designer

github.com/tradermontyAgent 工作流3.4k3.2k 次安装2 天前更新
代码仓库

关于 skill-designer

一个 Python 命令行技能，可将结构化的技能构想转为 Claude CLI 提示词。它结合仓库规范、参考指南和现有技能清单，辅助搭建技能目录。

主要功能

  1. 01读取 JSON 技能规格
  2. 02构建 Claude CLI 提示词
  3. 03纳入结构与质量参考资料
  4. 04列出现有技能以避免重复
  5. 05将提示词输出到标准输出

适用场景

  1. 01根据构想规格搭建新技能
  2. 02为自动技能生成流程准备提示词
  3. 03按仓库规范检查生成的技能

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tradermonty/claude-trading-skills --skill skill-designer

安装后在 Claude Code 中输入/skill-designer确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

requirements.txt
references/
quality-checklist.md
skill-structure-guide.md
skill-template.md
scripts/
build_design_prompt.py
scripts/tests/
conftest.py
test_build_design_prompt.py

详细介绍

技能设计器

概述

根据结构化的技能创意说明生成一份全面的 Claude CLI 提示词。该提示词会指示 Claude 按照仓库规范创建完整的技能目录，其中包括带有 YAML frontmatter 的 SKILL.md、参考文档、辅助脚本和测试脚手架。

使用场景

  • 技能自动生成流水线从待办列表中选取一个创意，需要为 claude -p 生成设计提示词
  • 开发者想根据 JSON 创意说明快速搭建新技能
  • 生成技能的质量审查需要参考评分标准

前置条件

  • Python 3.9+
  • 无需外部 API 密钥
  • 参考文件必须位于 references/ 下

工作流

步骤 1：准备创意说明

接受一个 JSON 文件（--idea-json），其中包含：

  • title：易于理解的创意名称
  • description：技能的功能
  • category：技能类别（例如 trading-analysis、developer-tooling）

接受一个规范化的技能名称（--skill-name），该名称将用作目录名和 YAML frontmatter 中的 name: 字段。

步骤 2：构建设计提示词

运行提示词构建器：

python3 skills/skill-designer/scripts/build_design_prompt.py \
  --idea-json /tmp/idea.json \
  --skill-name "my-new-skill" \
  --project-root .

该脚本会：

  1. 加载创意 JSON 文件
  2. 读取全部三个参考文件（结构指南、质量检查清单、模板）
  3. 列出现有技能（最多 20 个），以避免重复
  4. 将完整提示词输出到 stdout
步骤 3：将提示词传递给 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
步骤 4：验证输出

Claude 创建技能后，请确认：

  • skills/<skill-name>/SKILL.md 存在，且 frontmatter 正确
  • 目录结构符合规范
  • 使用 dual-axis-skill-reviewer 评分，结果达到阈值

输出格式

脚本会将纯文本提示词输出到 stdout。成功时退出代码为 0；缺少必需参考文件时退出代码为 1。

资源

  • references/skill-structure-guide.md -- 目录结构、SKILL.md 格式、命名规范
  • references/quality-checklist.md -- 双轴审查器的 5 类检查清单（100 分）
  • references/skill-template.md -- 包含 YAML frontmatter 和标准章节的 SKILL.md 模板
  • scripts/build_design_prompt.py -- 提示词构建脚本（CLI 接口）

评论

支持 Markdown