代码委派基础版

核心功能: 本技能提供中文交互、的基础能力、化工作流场景等能力。

代码委派基础版

核心能力

• 编程任务的委派与编排：接收自然语言描述的编程需求，转化为可执行的子任务序列
• 任务分类与简单分解：将复杂需求拆分为基础代码生成、代码补全、简单重构等可管理单元
• 基础代码生成与输出校验：根据子任务生成对应代码片段，并对输出做基础语法与格式校验
• 执行日志记录：记录每个子任务的执行状态与耗时，便于回溯问题

适用场景

不适用于：需要跨多仓库深度分析、大规模批量改写、复杂架构决策的场景（请使用高级版）

使用流程

1. 接收用户的自然语言编程需求，明确目标语言与运行环境
2. 将需求分解为若干子任务，按依赖顺序排列
3. 依次执行子任务，生成代码片段并做基础语法校验
4. 汇总结果，输出完整代码与执行日志
5. 若执行中出现错误，按异常处理章节的指引重试或回退

输入格式

输出格式

{
  "success": true,
  "data": {
    "final_result": {
      "generated_code": "生成的代码片段",
      "language": "python",
      "line_count": 24
    },
    "execution_log": [
      {
        "step": 1,
        "name": "需求解析",
        "status": "completed",
        "duration_ms": 1200,
        "output_summary": "识别为代码生成任务"
      },
      {
        "step": 2,
        "name": "代码生成",
        "status": "completed",
        "duration_ms": 3500,
        "output_summary": "已生成目标函数"
      },
      {
        "step": 3,
        "name": "语法校验",
        "status": "completed",
        "duration_ms": 800,
        "output_summary": "语法检查通过"
      }
    ],
    "total_duration_ms": 5500,
    "steps_completed": 3,
    "steps_total": 3
  },
  "error": null
}

异常处理

依赖说明

运行环境

• Agent平台: 支持SKILL.md规范的任意AI Agent
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

• 本Skill基于指令驱动，无需额外API Key（除内容中明确标注的外部API）

可用性分类

• 分类: MD+EXEC（）
• 说明: 基于Markdown的AI Skill，

案例展示

示例1：生成一个排序函数

输入: "用 Python 实现一个快速排序函数，输入为整数列表"
处理: 分解为需求解析 -> 代码生成 -> 语法校验
输出: 包含 quicksort 函数的 Python 代码片段

示例2：为已有函数补全文档

输入: 代码文件路径与"为每个公开函数补充 docstring"
处理: 读取文件 -> 识别公开函数 -> 生成 docstring -> 合并输出
输出: 补全 docstring 后的完整代码

常见问题

Q1: 如何开始使用代码委派基础版？

A: 查看使用流程章节，确认运行环境满足依赖说明中的要求，然后按"输入格式"提供任务描述即可。

Q2: 遇到语法校验失败怎么办？

A: 请参考异常处理章节。基础版会在 max_retries 范围内自动重试一次；若仍失败，建议细化任务描述或拆分为更小的子任务。

Q3: 代码委派基础版有什么限制？

A: 基础版不支持多步门控、断点续传与复杂重试策略，如需更稳健的执行能力，可升级至高级版。

Q4: 如何获取多步门控、断点续传等高级能力？

A: 这些属于高级版能力。基础版聚焦于任务委派的核心流程，如需在复杂项目中使用门控校验、断点续传与多级重试，请升级至高级版。

错误处理

已知限制

• 单步最大重试次数为 1 次，复杂场景可能需要人工介入
• 不支持多步门控（gates）机制，无法在关键步骤进行人工或自动校验
• 不支持断点续传，任务中断后需从头执行
• 不支持跨多仓库的深度代码分析与批量改写
• ，复杂任务建议拆分为多个小任务

安全注意事项

使用前请确认已阅读依赖说明章节，确保运行环境满足安全要求。

效率量化分析

差异化对比

核心功能

• 自动化执行: 基于指令驱动的自动化流程
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果