coze-skill-creator

Coze Skill Creator

任务目标

• 本 Skill 用于:从配置文件或需求描述创建完整的 Skill，包括工具配置、工作流编排和代码生成
• 能力包含:配置验证、文件生成、模板渲染、技能打包
• 触发条件:用户描述技能需求、提供技能配置 JSON、设计工作流结构

前置准备

• 依赖说明:scripts 脚本所需的依赖包及版本

  jsonschema>=4.0.0
  

• 非标准文件/文件夹准备:无

操作步骤

• 标准流程:

  1. 需求分析
     • 智能体根据用户描述，理解技能的核心能力、触发场景和工具需求
     • 参考 references/config-reference.md 确定配置结构
  2. 配置生成
     • 根据分析结果，生成技能配置 JSON 文件
     • 配置包含:元数据、工具列表、工作流节点、脚本定义
  3. Schema 验证
     • 调用 scripts/validate_schema.py --config <config_path> 验证配置格式
     • 若验证失败，根据错误信息修正配置
  4. 文件生成
     • 调用 scripts/generate_skill.py --config <config_path> --output <output_dir> 生成技能文件
     • 脚本自动创建 SKILL.md、scripts/、references/、assets/ 结构
  5. 打包测试
     • 使用 package_skill(skill_dir_name=<skill_name>) 工具打包技能
     • 验证 .skill 文件生成成功且内容完整

• 可选分支:

  • 当 用户提供配置 JSON:直接跳到步骤 3 进行验证
  • 当 仅需生成工作流设计:参考 references/workflow-guide.md，智能体生成工作流图和节点定义
  • 当 仅需配置工具集成:参考 references/tool-reference.md，智能体生成工具配置

资源索引

• 必要脚本:
  • scripts/validate_schema.py (用途与参数:验证技能配置 JSON 是否符合 Schema，参数:--config)
  • scripts/generate_skill.py (用途与参数:根据配置生成完整技能文件，参数:--config, --output)
• 领域参考:
  • references/config-reference.md (何时读取:生成或验证配置时)
  • references/workflow-guide.md (何时读取:设计工作流时)
  • references/tool-reference.md (何时读取:配置工具时)
• 输出资产:
  • assets/templates/skill-template.md (直接用于生成 SKILL.md)
  • assets/templates/python-script.py (直接用于生成 Python 脚本)
  • assets/templates/schema.json (用于验证配置格式)

注意事项

• 配置 JSON 必须符合 assets/templates/schema.json 定义的 Schema
• 生成的技能命名必须使用小写字母和连字符，禁止使用 -skill 后缀
• 工作流节点的连接关系必须保持有向无环图结构
• 充分利用智能体的自然语言理解能力，仅在需要结构化输出时调用脚本

使用示例

示例 1:从需求描述创建技能

• 功能说明:用户描述"需要一个处理图片压缩的技能"
• 执行方式:智能体分析需求→生成配置→脚本验证→生成文件→打包
• 关键参数:技能名称 image-compressor、描述、工具列表
• 配置示例:

  {
    "name": "image-compressor",
    "description": "压缩图片文件大小",
    "tools": [
      {
        "name": "compress",
        "type": "python",
        "parameters": [{"name": "quality", "type": "integer"}]
      }
    ]
  }
  

示例 2:从配置文件生成技能

• 功能说明:用户已提供 skill-config.json 配置文件
• 执行方式:脚本验证→脚本生成→打包
• 关键参数:--config skill-config.json, --output ./my-skill
• 命令:python scripts/generate_skill.py --config skill-config.json --output ./my-skill

示例 3:设计工作流

• 功能说明:用户需要创建包含分支逻辑的技能工作流
• 执行方式:智能体读取工作流指南→设计节点→生成配置→生成技能
• 关键参数:节点类型、连接关系、条件表达式
• 工作流示例:

  [开始] → [条件判断] → [分支A: API调用] → [结束]
                    ↘ [分支B: 本地处理] → [结束]