---
slug: "code-delegate"
name: "code-delegate"
version: 1.0.1
displayName: "代码委派工具专业版"
summary: "企业级批量代码委派,支持多任务并行、团队协作、权限治理与质量审计。面向团队与企业的高级代码委派工具,在免费版基础上扩展批量委派、并行执行、权限治理等能力。核心能力: - 多任务并行委派与任务"
summary_zh: "企业级批量代码委派,支持多任务并行、团队协作、权限治理与质量审计。面向团队与企业的高级代码委派工具,在免费版基础上扩展批量委派、并行执行、权限治理等能力。核心能力: - 多任务并行委派与任务"
license: "MIT"
edition: "pro"
description: |-
  面向团队与企业的高级代码委派工具,在免费版基础上扩展批量委派、并行执行、权限治理等能力。核心能力:
  - 多任务并行委派与任务队列管理
  - 写入保护插件与权限治理
  - 团队协作会话与任务分发
  - 委派质量审计与代码审查报告
  - 批量测试验证与回归测试

  适用场景:
  - 企业级批量代码重构
  - 多模块并行开发与测试
  - 代码质量治理与审计追踪

  差异化:
  - 兼容免费版全部能力,无缝升级
  - 支持多任务并行与队列管理
  - 提供权限治理与审计能力
  - 优先技术支持与更新通道
tags:
  - 开发工具
  - 代码委派
  - 企业级
  - 批量执行
  - 权限治理
  - 代码生成
  - 编程辅助
  - bash
  - 任务
  - true
  - projects
tools:
  - read
  - exec
  - write
  - glob
  - grep
homepage: ""
category: "Development"
---
# 代码委派工具专业版

## 付费版专享能力

| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 代码静态分析与质量评分 | 不支持 | 支持 |
| 依赖漏洞检测与升级建议 | 不支持 | 支持 |
| 批量代码审查与报告生成 | 不支持 | 支持 |
| CI/CD流水线集成 | 不支持 | 支持 |
| 代码复杂度可视化与重构建议 | 不支持 | 支持 |

## 核心能力

### 1. 多任务并行委派
支持同时委派多个任务,并行执行提高效率:

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

**输出**: 返回多任务并行委派的处理结果,包含执行状态码、结果数据和执行日志.
### 2. 任务队列管理
| 功能 | 说明 |
|:-----|:-----|
| 任务排队 | 超过并行上限的任务自动排队 |
| 优先级 | 支持任务优先级设置 |
| 依赖管理 | 任务间可配置依赖关系 |
| 失败重试 | 自动重试失败任务 |
| 状态追踪 | 实时查看每个任务状态 |

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

**输入**: 用户提供任务队列管理所需的指令和必要参数.
### 3. 写入保护与权限治理
```json
{
  "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"
  }
}
```

**输入**: 用户提供写入保护与权限治理所需的指令和必要参数.
**处理**: 解析写入保护与权限治理的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回写入保护与权限治理的处理结果,包含执行状态码、结果数据和执行日志。- 验证执行结果,确认输出符合预期格式
- 异常时参考错误处理章节进行恢复
- 关键参数: `写入保护与权限治理` 选项

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

**输入**: 用户提供团队协作会话所需的指令和必要参数.
**处理**: 解析团队协作会话的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
### 5. 质量审计与代码审查
```bash
# 委派后自动审计
请委派代码重构任务并执行质量审计:
任务: 将 src/legacy/ 重构为现代架构
审计项: 代码覆盖率、复杂度、安全扫描
输出: 重构报告 + 质量评分
```

审计维度:

| 维度 | 检查项 | 评分标准 |
|---:|---:|---:|
| 代码质量 | 复杂度、重复率、圈复杂度 | < 10 为优秀 |
| 测试覆盖 | 单元测试覆盖率 | > 80% 为优秀 |
| 安全性 | 注入风险、敏感信息 | 0 漏洞为优秀 |
| 规范性 | 代码风格、命名、注释 | 100% 符合为优秀 |

#
## 快速开始

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

> 详细的输入输出格式请参考下方章节说明。

## 适用场景

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

对遗留系统做大规模重构,多个模块并行处理.
```bash
# 批量重构委派
请并行委派以下重构任务:
项目: projects/legacy-system
模块:
1. [auth] 迁移到 JWT 认证
2. [database] 切换到 ORM
3. [api] 重构为 RESTful 设计
4. [frontend] 迁移到新框架
并行度: 3
每个任务: 完成后自动测试
汇总: 生成重构进度报告
```

输出示例:

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

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

新项目启动,多个模块同步开发.
```bash
# 并行开发 + 批量测试
请委派以下开发任务(并行):
1. 创建用户管理模块
2. 创建订单管理模块
3. 创建支付模块
完成后: 自动运行集成测试
输出: 开发报告 + 测试结果
```

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

定期对代码库做质量审计,追踪改进.
```bash
# 季度代码审计
请对 projects/main-system 执行全面质量审计:
审计范围: 所有 Python 文件
审计项: 复杂度、覆盖率、安全、规范
对比基线: 上季度审计报告
输出: 趋势报告 + 改进建议
```

## 使用流程

### 优秀步: 初始化工具配置

```bash
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
```

### 第二步: 配置写入保护

```bash
# 创建写入保护配置
cat > .delegate-toolkit/write-guard.json << 'EOF'
{
  "protected": [".skill-platform/", "**/auth/**", "**/*.env"],
  "allowed": ["projects/**", "workspace/**"],
  "log": ".delegate-toolkit/logs/write-audit.log"
}
EOF
```

### 第三步: 执行批量委派

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

#
## 输入格式

| 参数名 | 类型 | 必填 | 说明 |
|:---:|:---:|:---:|:---:|
| content | string | 否 | code-delegate处理的内容输入 |, 默认: 全部维度 |
| strict_level | string | 否 | 审查严格度, 可选: strict/normal/loose, 默认: normal |

## 输出格式

```json
{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}
```

## 异常处理

| 错误场景 | 原因 | 处理方式 |
|:------|------:|:------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 

## 依赖说明

### 运行环境

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

### 第三方依赖

| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---:|:---|---:|---:|
| 代码 CLI | CLI 工具 | 必需 | `npm install -g @anthropic-ai/claude-code` |
| LLM API | API | 必需 | 由代码 CLI 内置 LLM 提供 |
| Node.js | 运行时 | 必需 | nodejs.org |
| jq(可选) | CLI 工具 | 审计推荐 | 系统包管理器 |

### API Key 配置

- 代码 CLI 认证通过交互式登录完成
- 如需在 CI/CD 中使用,配置环境变量:

```bash
export ANTHROPIC_API_KEY="your-api-key"
# 或
export CLAUDE_CODE_API_KEY="your-api-key"
```

### 可用性分类

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

## 案例展示

### 企业级配置

```json
{
  "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/**"],
    "log_file": ".delegate-toolkit/logs/write-audit.log"
  },
  "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
  }
}
```

### 任务依赖配置

```json
{
  "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"]
    }
  ]
}
```

## 常见问题

### Q1: 专业版是否兼容免费版的委派命令?

完全兼容。专业版使用相同的 `claude -p` 命令,免费版的任务可直接在专业版中管理.
### Q2: 并行任务数有上限吗?

默认最大并行 5 个任务,可通过配置调整。超过限制的任务自动排队等待.
### Q3: 写入保护会阻止正常开发吗?

不会。保护只针对配置文件和敏感目录,项目代码目录在允许列表内,正常开发不受影响.
### Q4: 任务依赖如何配置?

在任务配置中指定 `depends_on` 字段,工具会自动按依赖顺序执行:

```json
{"depends_on": ["task-1"]}
```

### Q5: 审计报告存在哪里?

默认存储在 `.delegate-toolkit/reports/` 下,包含每次委派的质量评分与详细审计结果.
### Q6: 如何获得优先技术支持?

专业版用户可通过专属通道提交问题,通常 1 个工作日内响应.
## 错误处理

| 错误场景(续)| 原因 | 处理方式 |
|:---------:|-----------|:----------|
| LLM响应超时或无响应 | 网络延迟或模型负载过高 | ，请求；确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求，参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述，补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求；检查命令权限设置 |

