> 核心功能: 本技能提供中文交互等能力。
> 核心功能: 本技能提供结构化的工作流程和配置指引、化工作流场景等能力。

代码委派工具专业版

简介

代码委派工具专业版为企业团队提供高级代码委派能力。在免费版单任务委派基础上,扩展了多任务并行、权限治理、团队协作、质量审计等功能,满足企业级批量开发的需求.
专业版完全兼容免费版的委派命令与异步流程,已有工作流可无缝升级.

能力一览

1. 多任务并行委派

支持同时委派多个任务,并行执行提高效率:
具体操作方式与参数说明请参考下方示例代码.

输入参数

请并行委派以下任务到项目 microservices:
1. [auth-service] 实现 OAuth 2.1 认证流程
2. [order-service] 添加订单状态机
3. [payment-service] 集成第三方支付
4. [notification-service] 实现消息推送
每个任务: 独立会话,完成后通知

处理: 解析多任务并行委派的输入参数,完成核心逻辑,输出结构化数据.
输出: 返回多任务并行委派的响应数据,包含状态信息、结果数据和执行记录.
- 通过input_params参数指定操作类型(创建/查询/导出)

2. 任务队列管理

请委派以下任务:
任务A: 创建数据库 Schema (优先级: 高)
任务B: 实现数据访问层 (依赖: A)
任务C: 编写业务逻辑 (依赖: B)
任务D: 添加 API 端点 (依赖: C)
并行度: 2(同时执行 2 个无依赖任务)

处理: 解析任务队列管理的输入参数,完成核心逻辑,输出结构化数据.
输出: 返回任务队列管理的响应数据,包含状态信息、结果数据和执行记录.

3. 写入保护与权限治理

{
  "write_guard": {
    "enabled": true,
    "protected_paths": [
      ".skill-platform/",
      "LaunchAgents/",
      "**/auth-profiles/**",
      "**/*.env",
      "**/secrets/**"
    ],
    "allowed_paths": [
      "projects/**",
      "workspace/**"
    ],
    "log_file": ".delegate-toolkit/logs/write-audit.log"
  }

处理: 解析写入保护与权限治理的输入参数,完成核心逻辑,输出结构化数据.
输出: 返回写入保护与权限治理的响应数据,包含状态信息、结果数据和执行记录.
- 通过input_params参数指定操作类型(创建/查询/导出)

4. 团队协作会话

请将以下任务分发给团队:
任务1 → 开发者A: 实现前端组件
任务2 → 开发者B: 实现 API 端点
任务3 → 开发者C: 编写测试用例
汇总: 所有任务完成后生成集成报告

处理: 解析团队协作会话的输入参数,完成核心逻辑,输出结构化数据.
输出: 返回团队协作会话的响应数据,包含状态信息、结果数据和执行记录.
- 通过input_params参数指定操作类型(创建/查询/导出)

5. 质量审计与代码审查

请委派代码重构任务并执行质量审计:
任务: 将 src/legacy/ 重构为现代架构
审计项: 代码覆盖率、复杂度、安全扫描
输出: 重构报告 + 质量评分

审计维度:
| 维度 | 检查项 | 评分标准 |
|---:|---:|---:|
| 代码质量 | 复杂度、重复率、圈复杂度 | < 10 为优秀 |
| 测试覆盖 | 单元测试覆盖率 | > 80% 为优秀 |
| 安全性 | 注入风险、敏感信息 | 0 漏洞为优秀 |
| 规范性 | 代码风格、命名、注释 | 100% 符合为优秀 |
处理: 解析质量审计与代码审查的输入参数,完成核心逻辑,输出结构化数据.
输出: 返回质量审计与代码审查的响应数据,包含状态信息、结果数据和执行记录.
能力覆盖范围：支持的场景关键词如下：企业级批量代码委、支持多任务并行、权限治理与质量审、面向团队与企业的、高级代码委派工具、在免费版基础上扩、展批量委派、权限治理等能力、核心能力、多任务并行委派与、写入保护插件与权、团队协作会话与任、委派质量审计与代、码审查报告、批量测试验证与回、归测试等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.

典型场景

场景一: 企业级批量代码重构

对遗留系统做大规模重构,多个模块并行处理.

请并行委派以下重构任务:
项目: projects/legacy-system
模块:
1. [auth] 迁移到 JWT 认证
2. [database] 切换到 ORM
3. [api] 重构为 RESTful 设计
4. [frontend] 迁移到新框架
并行度: 3
每个任务: 完成后自动测试
汇总: 生成重构进度报告

输出示例:

批量重构报告 - projects/legacy-system
=====================================
任务状态:
1. [auth]     JWT 认证迁移   ✅ 完成 (耗时: 8分钟)
2. [database] ORM 切换        ✅ 完成 (耗时: 12分钟)
3. [api]      RESTful 重构    ✅ 完成 (耗时: 15分钟)
4. [frontend] 框架迁移        ⏳ 进行中 (预计 20分钟)
质量审计:
- 代码覆盖率: 85% (优秀)
- 复杂度降低: 40%
- 安全漏洞: 0 (优秀)
- 规范符合: 92% (良好)
总体评分: 89/100 (良好)
建议: 前端任务完成后做集成测试

场景二: 多模块并行开发与测试

新项目启动,多个模块同步开发.

请委派以下开发任务(并行):
1. 创建用户管理模块
2. 创建订单管理模块
3. 创建支付模块
完成后: 自动运行集成测试
输出: 开发报告 + 测试结果

场景三: 代码质量治理与审计

定期对代码库做质量审计,追踪改进.

请对 projects/main-system 执行全面质量审计:
审计范围: 所有 Python 文件
审计项: 复杂度、覆盖率、安全、规范
对比基线: 上季度审计报告
输出: 趋势报告 + 改进建议

排除场景

以下场景代码委派工具专业版不适合处理：
- 无明确技术栈的模糊需求
- 纯架构设计决策
- 运维部署管理

激活条件

需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于非本工具能力范围的需求.

迅速上手

领先步: 初始化工具配置

mkdir -p .delegate-toolkit/{logs,reports,configs}
cat > .delegate-toolkit/config.json << 'EOF'
{
  "edition": "pro",
  "parallel": {
    "max_concurrent": 5,
    "queue_enabled": true,
    "retry_count": 2
  },
  "write_guard": {
    "enabled": true,
    "protected_paths": ["**/*.env", "**/secrets/**"],
    "allowed_paths": ["projects/**"]
  },
  "audit": {
    "enabled": true,
    "dimensions": ["quality", "coverage", "security", "standards"],
    "auto_test": true
  }
EOF

第二步: 配置写入保护

cat > .delegate-toolkit/write-guard.json << 'EOF'
{
  "protected": [".skill-platform/", "**/auth/**", "**/*.env"],
  "allowed": ["projects/**", "workspace/**"],
}
EOF

第三步: 执行批量委派

请并行委派 5 个开发任务
并行度: 3
完成后: 自动测试 + 生成报告

响应解析: 完成完成后,查看输出响应确认任务状态。成功时输出包含解析摘要和响应数据;失败时根据错误信息排查问题,查阅错误解析章节获取恢复步骤.

应用示例

企业级配置

{
  "edition": "pro",
  "organization": {
    "name": "开发团队",
    "team_members": ["dev-a", "dev-b", "dev-c"]
  },
  "parallel": {
    "max_concurrent": 5,
    "queue_enabled": true,
    "priority_enabled": true,
    "dependency_aware": true
  },
  "write_guard": {
    "enabled": true,
    "protected_paths": [
      ".skill-platform/",
      "**/*.env",
      "**/secrets/**",
      "**/config/production/**"
    ],
    "allowed_paths": ["projects/**", "workspace/**"],
  },
  "audit": {
    "enabled": true,
    "dimensions": ["quality", "coverage", "security", "standards"],
    "auto_test": true,
    "baseline": ".delegate-toolkit/reports/baseline.json"
  },
  "team": {
    "task_distribution": "round-robin",
    "shared_sessions": true,
    "review_required": true
  }

任务依赖配置

{
  "task_queue": [
    {
      "id": "task-1",
      "name": "创建数据库 Schema",
      "priority": "high",
      "depends_on": []
    },
    {
      "id": "task-2",
      "name": "实现数据访问层",
      "priority": "medium",
      "depends_on": ["task-1"]
    },
    {
      "id": "task-3",
      "name": "编写业务逻辑",
      "priority": "medium",
      "depends_on": ["task-2"]
    }
  ]
}

优选实践指南

1. 任务拆分原则

保护范围:
- 平台配置文件 (.skill-platform/)
- 认证信息 (auth-profiles)
- 环境变量文件 (*.env)
- 密钥目录 (secrets/)
允许范围:
- 项目目录 (projects/**)
- 工作空间 (workspace/**)

3. 免费版与专业版能力对比

质量评分标准:
90-100: 优秀,可作为范例
70-89:  良好,小幅优化
50-69:  需改进,重新委派
<50:    不合格,需重新设计

疑问汇编

Q1: 本技能的适用范围是什么?

A: 请参考适用场景章节。超出范围的需求可能无法得到预期结果,建议先查看不适用场景列表。

Q2: API Key如何安全配置?

A: 通过环境变量注入,严禁硬编码在代码或配置文件中。参考认证章节的安全红线说明。

Q3: 遇到限流(429)如何处理?

A: 降低请求频率,等待2-5秒后重试。持续限流请检查API配额或联系服务提供方。

Q4: 如何获取更高质量的输出?

A: 提供更详细的输入描述,确保参数值具体明确。参考案例展示中的优选实践示例。

Q5: 技能更新后旧版本配置是否兼容?

A: 向后兼容。但建议及时更新到最新版本以获取新功能和修复。查看版本变更日志了解详情。

安装与配置

运行环境

• Agent 平台: 支持读取 SKILL.md 的任意 AI Agent( Code / Cursor / Codex / CLI 等)
• 操作系统: Windows / macOS / Linux
• Node.js: 16+(代码 CLI 运行)
• Bash: 4.0+(任务队列脚本)

第三方依赖

export _API_KEY="${API_KEY:?请设置环境变量}"
export _CODE_API_KEY="${API_KEY:?请设置环境变量}"

可用性分类

• 分类: MD+EXEC+SCRIPT(Markdown 指令 + 命令行执行 + 任务管理脚本)
• 说明: 通过自然语言指令驱动 Agent 委派批量编程任务,支持队列管理与质量审计
• 离线可用: 否,代码 CLI 需要连接 LLM API

异常处理策略

指南中心

增强内容 - completeness

功能边界条件

以下列出代码委派工具专业版的功能边界条件，以表格形式呈现。

这些边界条件确保了工具的稳定性和安全性，同时也为用户提供了明确的预期。

错误处理方案

以下列出代码委派工具专业版可能遇到的错误及其处理方案。

这些错误处理方案旨在帮助用户快速定位问题并解决问题。

输入输出参数说明

以下列出代码委派工具专业版的输入输出参数说明。

这些参数为用户提供了灵活的配置选项，以适应不同的使用场景。

依赖说明

• LLM/API Key: 需要配置相应的API密钥
• 网络连接: 需要访问外部服务
• 文件系统: 需要读写文件权限
• 运行时环境: 需要相应的命令行工具