back
loading skill details...
企业级代码委派工具,支持多任务并行、权限治理、团队协作及质量审计,提升批量重构与开发效率。
---
slug: code-delegate
name: code-delegate
version: "1.0.0"
displayName: 代码委派工具专业版
summary: 企业级批量代码委派,支持多任务并行、团队协作、权限治理与质量审计
license: Proprietary
edition: pro
description: |-
面向团队与企业的高级代码委派工具,在免费版基础上扩展批量委派、并行执行、权限治理等能力。核心能力:
- 多任务并行委派与任务队列管理
- 写入保护插件与权限治理
- 团队协作会话与任务分发
- 委派质量审计与代码审查报告
- 批量测试验证与回归测试
适用场景:
- 企业级批量代码重构
- 多模块并行开发与测试
- 代码质量治理与审计追踪
差异化:
- 兼容免费版全部能力,无缝升级
- 支持多任务并行与队列管理
- 提供权限治理与审计能力
- 优先技术支持与更新通道
tags:
- 开发工具
- 代码委派
- 企业级
- 批量执行
- 权限治理
tools:
- - read
- exec
---
# 代码委派工具专业版
## 核心能力
### 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"
}
}
```
**输入**: 用户提供写入保护与权限治理所需的指令和必要参数。
**处理**: 按照skill规范执行写入保护与权限治理操作,遵循单一意图原则。
**输出**: 返回写入保护与权限治理的执行结果,包含操作状态和输出数据。
- 执行`写入保护与权限治理`操作,处理输入数据并返回结果
- 验证执行结果,确认输出符合预期格式
- 异常时参考错误处理章节进行恢复
- 关键参数: `写入保护与权限治理` 选项
### 4. 团队协作会话
```bash
# 分发任务给团队成员
请将以下任务分发给团队:
任务1 → 开发者A: 实现前端组件
任务2 → 开发者B: 实现 API 端点
任务3 → 开发者C: 编写测试用例
汇总: 所有任务完成后生成集成报告
```
**输入**: 用户提供团队协作会话所需的指令和必要参数。
**处理**: 按照skill规范执行团队协作会话操作,遵循单一意图原则。
### 5. 质量审计与代码审查
```bash
# 委派后自动审计
请委派代码重构任务并执行质量审计:
任务: 将 src/legacy/ 重构为现代架构
审计项: 代码覆盖率、复杂度、安全扫描
输出: 重构报告 + 质量评分
```
审计维度:
| 维度 | 检查项 | 评分标准 |
|:-----|:-------|:---------|
| 代码质量 | 复杂度、重复率、圈复杂度 | < 10 为优秀 |
| 测试覆盖 | 单元测试覆盖率 | > 80% 为优秀 |
| 安全性 | 注入风险、敏感信息 | 0 漏洞为优秀 |
| 规范性 | 代码风格、命名、注释 | 100% 符合为优秀 |
### 能力覆盖范围
本skill还覆盖以下能力场景: 企业级批量代码委、支持多任务并行、权限治理与质量审、面向团队与企业的、高级代码委派工具、在免费版基础上扩、展批量委派、权限治理等能力、核心能力、多任务并行委派与、写入保护插件与权、团队协作会话与任、委派质量审计与代、码审查报告、批量测试验证与回、归测试。这些能力在上述核心功能中均有对应处理逻辑。
**输入**: 用户提供质量审计与代码审查所需的指令和必要参数。
## 适用场景
### 场景一: 企业级批量代码重构
对遗留系统做大规模重构,多个模块并行处理。
```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
完成后: 自动测试 + 生成报告
```
### 命令参数说明
- `-system`: 命令参数,用于指定操作选项
- `-service`: 命令参数,用于指定操作选项
- `-robin`: 命令参数,用于指定操作选项
- `-guard`: 命令参数,用于指定操作选项
- `-profiles`: 命令参数,用于指定操作选项
**结果处理**: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,参考错误处理章节获取恢复步骤。
### 命令参数说明
- `-platform`: 命令参数,用于指定操作选项
- `-api-key`: 命令参数,用于指定操作选项
- `-audit`: 命令参数,用于指定操作选项
## 输入格式
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| content | string | 是 | 相关说明 |
| content | string | 否 | 相关说明, 默认: 全部维度 |
| 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
}
```
## 异常处理
| 错误场景 | 原因 | 处理方式 |
|---------|------|---------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
## 依赖说明
### 运行环境
- **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响应超时或无响应 | 网络延迟或模型负载过高 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接,执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令请求;确认Agent平台LLM服务正常 |
| 输入内容格式不正确 | 用户输入不符合skill预期格式 | 检查输入是否符合skill使用说明中的格式要求,参考示例章节 |
| 执行结果与预期不符 | 指令描述不够明确或上下文不足 | 提供更详细的指令描述,补充必要的上下文信息 |
| 命令执行失败 | 运行环境不满足要求或权限不足 | 确认运行环境符合依赖说明中的要求;检查命令权限设置 |
## 已知限制
-
-
-
don't have the plugin yet? install it then click "run inline in claude" again.