Code Dev Toolkit

SKILL.md

---
slug: code-dev-toolkit
name: code-dev-toolkit
version: "1.0.0"
displayName: 代码开发工具包专业版
summary: 企业级编码工作流,支持多任务编排、团队规范、质量门禁与交付审计
license: Proprietary
edition: pro
description: |-
  面向团队与企业的高级代码开发工作流工具,在免费版基础上扩展多任务编排、团队规范、质量门禁等能力。核心能力:
  - 多任务并行编排与依赖管理
  - 团队编码规范与质量门禁
  - 代码审查工作流与审计追踪
  - CI/CD 集成与交付流水线
  - 多环境配置与发布管理

  适用场景:
  - 企业级多功能并行开发
  - 团队协作与代码审查
  - 持续集成与持续交付

  差异化:
  - 兼容免费版全部能力,无缝升级
  - 支持多任务编排与质量门禁
  - 提供团队规范与审计追踪
  - 优先技术支持与更新通道

tags:
- 开发工具
- 编码工作流
- 企业级
- 多任务编排
- CI/CD
tools:
  - - read
- exec
---
# 代码开发工具包专业版

## 核心能力

### 1. 多任务并行编排
```text
多功能并行开发:
  任务A: 用户认证 ──┐
  任务B: 订单管理 ──┤── 集成测试
  任务C: 支付集成 ──┘
```

```bash
# 多任务编排
请编排以下开发任务:
任务1: 实现 JWT 认证 (优先级: 高, 无依赖)
任务2: 实现订单 CRUD (优先级: 中, 依赖: 无)
任务3: 实现支付回调 (优先级: 中, 依赖: 任务1)
任务4: 集成测试 (优先级: 高, 依赖: 任务1,2,3)
并行度: 2
```

**处理**: 按照skill规范执行多任务并行编排操作,遵循单一意图原则。
**输出**: 返回多任务并行编排的执行结果,包含操作状态和输出数据。

- 执行`CI/CD 集成`操作，处理输入数据并返回结果
- 验证执行结果，确认输出符合预期格式
- 参考`CI/CD 集成`相关配置参数进行设置
### 2. 团队编码规范
```json
{
  "team_standards": {
    "code_style": {
      "language": "python",
      "linter": "ruff",
      "formatter": "black",
      "type_checker": "mypy"
    },
    "naming": {
      "functions": "snake_case",
      "classes": "PascalCase",
      "constants": "UPPER_SNAKE"
    },
    "requirements": {
      "type_hints": true,
      "docstrings": true,
      "test_coverage_min": 80
    }
  }
}
```

**输入**: 用户提供团队编码规范所需的指令和必要参数。
**处理**: 按照skill规范执行团队编码规范操作,遵循单一意图原则。
**输出**: 返回团队编码规范的执行结果,包含操作状态和输出数据。

### 3. 质量门禁
| 门禁项 | 阈值 | 不通过处理 |
|:-------|:-----|:-----------|
| 测试覆盖率 | >= 80% | 阻止交付 |
| Lint 检查 | 0 错误 | 阻止交付 |
| 类型检查 | 0 错误 | 阻止交付 |
| 安全扫描 | 0 高危 | 阻止交付 |
| 代码复杂度 | < 15 | 警告 |

```bash
# 质量门禁检查
请对当前变更执行质量门禁检查:
- 测试覆盖率 >= 80%
- Lint 0 错误
- 类型检查 0 错误
- 安全扫描 0 高危
不通过项: 阻止交付并给出修复建议
```

**输出**: 返回质量门禁的执行结果,包含操作状态和输出数据。
### 4. 代码审查工作流
```text
开发 → 自测 → 提交 → 审查 → 修改 → 合并
```

```bash
# 代码审查流程
请审查本次变更:
审查者: 自动分配(轮询)
审查项:
- 代码规范符合度
- 逻辑正确性
- 安全风险
- 性能影响
- 测试覆盖
输出: 审查报告 + 修改建议
```

**输入**: 用户提供代码审查工作流所需的指令和必要参数。
**处理**: 按照skill规范执行代码审查工作流操作,遵循单一意图原则。

- 执行`代码审查工作流`操作,处理输入数据并返回结果
- 验证执行结果,确认输出符合预期格式
- 异常时参考错误处理章节进行恢复
- 关键参数: `代码审查工作流` 选项

### 5. CI/CD 集成
```yaml
# CI/CD 流水线配置
pipeline:
  - stage: plan
    script: |
      # 规划任务拆分
      code-toolkit plan --task "$TASK_DESCRIPTION"

  - stage: implement
    parallel: 3
    script: |
      code-toolkit execute --step $STEP

  - stage: verify
    script: |
      code-toolkit verify --quality-gate

  - stage: review
    script: |
      code-toolkit review --auto-assign

  - stage: deliver
    script: |
      code-toolkit deliver --audit
```

- 执行`CI/CD 集成`操作,处理输入数据并返回结果
- 验证执行结果,确认输出符合预期格式
- 异常时参考错误处理章节进行恢复
- 关键参数: `ci/cd_集成` 选项

### 能力覆盖范围

本skill还覆盖以下能力场景: 企业级编码工作流、支持多任务编排、团队规范、质量门禁与交付审、面向团队与企业的、高级代码开发工作、流工具、在免费版基础上扩、展多任务编排、质量门禁等能力、核心能力、多任务并行编排与、依赖管理、团队编码规范与质、代码审查工作流与、审计追踪、集成与交付流水线、多环境配置与发布。这些能力在上述核心功能中均有对应处理逻辑。
## 适用场景

### 场景一: 企业级多功能并行开发
新项目启动,多个功能模块同步开发。

```bash
# 多功能并行开发
请编排以下开发任务:
项目: e-commerce-platform
任务:
1. [auth] 实现 OAuth 2.1 认证 (高优先级, 无依赖)
2. [product] 实现商品管理 CRUD (中优先级, 无依赖)
3. [order] 实现订单流程 (中优先级, 依赖: auth, product)
4. [payment] 实现支付集成 (中优先级, 依赖: order)
5. [test] 集成测试 (高优先级, 依赖: 全部)
并行度: 2
每个任务: 完成后自动质量检查
汇总: 开发进度报告
```

输出示例:

```text
开发编排报告 - e-commerce-platform
=====================================

任务状态:
1. [auth]     OAuth 认证     ✅ 完成 (覆盖率: 88%)
2. [product]   商品管理       ✅ 完成 (覆盖率: 85%)
3. [order]     订单流程       ✅ 完成 (覆盖率: 82%)
4. [payment]   支付集成       ⏳ 进行中 (进度: 60%)
5. [test]      集成测试       ⏸ 等待依赖

质量门禁:
- auth:     通过 ✅ (覆盖率 88%, 复杂度 8)
- product:  通过 ✅ (覆盖率 85%, 复杂度 12)
- order:    通过 ✅ (覆盖率 82%, 复杂度 14)
- payment:  待检查 ⏳

审计日志: .code-toolkit/audit/dev-20260718.log
```

### 场景二: 团队协作与代码审查
团队成员提交代码后,自动分配审查。

```bash
# 代码审查流程
请审查 PR #42 的代码变更:
变更范围: src/auth/ 目录
自动分配审查者: 按轮询分配
审查标准: 团队编码规范
输出: 审查报告 + 合并建议
```

审查报告示例:

```text
代码审查报告 - PR #42
=====================================

审查者: developer-b
变更文件: 8 个
审查结果: 需修改 (2 项建议)

通过项:
- 代码规范: 100% 符合 ✅
- 类型检查: 0 错误 ✅
- 测试覆盖: 85% (达标) ✅

需修改:
1. src/auth/login.py:45
   问题: 密码比对未使用常量时间比较
   建议: 使用 hmac.compare_digest()
   严重性: 高

2. src/auth/token.py:23
   问题: JWT 过期时间硬编码
   建议: 从配置读取
   严重性: 中

合并建议: 修复高严重性问题后可合并
```

### 场景三: 持续集成与持续交付
CI/CD 流水线中集成质量门禁与交付审计。

```bash
# CI/CD 流水线
请执行完整交付流水线:
阶段:
1. 规划: 任务拆分与依赖分析
2. 实现: 并行开发(并行度 3)
3. 验证: 质量门禁检查
4. 审查: 自动代码审查
5. 交付: 审计报告与发布
门禁: 全部通过才允许交付
```

## 使用流程

### 优秀步: 初始化项目配置
```bash
mkdir -p .code-toolkit/{audit,reports,configs}

cat > .code-toolkit/config.json << 'EOF'
{
  "edition": "pro",
  "workflow": {
    "parallel_tasks": 3,
    "dependency_aware": true,
    "auto_quality_gate": true
  },
  "standards": {
    "test_coverage_min": 80,
    "max_complexity": 15,
    "lint_errors_max": 0
  },
  "review": {
    "auto_assign": true,
    "min_reviewers": 1,
    "strategy": "round-robin"
  },
  "audit": {
    "enabled": true,
    "log_dir": ".code-toolkit/audit/",
    "retention_days": 180
  }
}
EOF
```

### 第二步: 配置团队规范
```bash
cat > .code-toolkit/team-standards.json << 'EOF'
{
  "code_style": {"linter": "ruff", "formatter": "black"},
  "requirements": {"type_hints": true, "test_coverage_min": 80}
}
EOF
```

### 第三步: 执行编排开发
```bash
# 多任务编排
请编排 5 个开发任务
并行度: 3
每任务完成: 自动质量检查
全部完成: 生成交付报告
```

### 命令参数说明

- `-commerce-platform`: 命令参数,用于指定操作选项
- `-ci-token`: 命令参数,用于指定操作选项
- `--task`: 命令参数,用于指定操作选项
- `-standards`: 命令参数,用于指定操作选项
- `-decides`: 命令参数,用于指定操作选项

**结果处理**: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,参考错误处理章节获取恢复步骤。

### 命令参数说明

- `--cov-fail-under`: 命令参数,用于指定操作选项
- `--quality-gate`: 命令参数,用于指定操作选项
- `--auto-assign`: 命令参数,用于指定操作选项
- `--cov`: 命令参数,用于指定操作选项
- `--step`: 命令参数,用于指定操作选项

## 输入格式

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| 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
- **Python**: 3.8+(质量门禁脚本)
- **Git**: 版本控制与审查流程

### 依赖说明
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:-------|:-----|:---------|:---------|
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |
| Python 3.8+ | 运行时 | 质量门禁必需 | python.org |
| Git | CLI 工具 | 代码审查必需 | 系统自带 |
| ruff(可选) | Linter | 规范检查 | `pip install ruff` |
| pytest(可选) | 测试框架 | 测试覆盖 | `pip install pytest` |
| mypy(可选) | 类型检查 | 类型门禁 | `pip install mypy` |
| bandit(可选) | 安全扫描 | 安全门禁 | `pip install bandit` |

### API Key 配置
- 本工具基于 Markdown 指令驱动,无需额外 API Key
- CI/CD 集成如需调用外部服务,配置对应凭据:

```bash
export CODE_TOOLKIT_CI_TOKEN="your-ci-token"
export CODE_TOOLKIT_REVIEW_WEBHOOK="https://hooks.example.com/review"
```

### 可用性分类
- **分类**: MD+EXEC+SCRIPT+AUDIT(Markdown 指令 + 命令行执行 + 质量脚本 + 审计日志)
- **说明**: 通过自然语言指令驱动 Agent 管理编码工作流,支持多任务编排与质量门禁
- **离线可用**: 核心工作流完全离线;CI/CD 集成与审查通知需要网络

## 案例展示

### 企业级配置
```json
{
  "edition": "pro",
  "organization": {
    "name": "开发团队",
    "team_members": ["dev-a", "dev-b", "dev-c"]
  },
  "workflow": {
    "parallel_tasks": 5,
    "dependency_aware": true,
    "auto_quality_gate": true,
    "auto_review": true
  },
  "standards": {
    "test_coverage_min": 80,
    "max_complexity": 15,
    "lint_errors_max": 0,
    "security_scan": true
  },
  "review": {
    "auto_assign": true,
    "min_reviewers": 2,
    "strategy": "round-robin",
    "conflict_resolution": "senior-decides"
  },
  "cicd": {
    "integration_enabled": true,
    "quality_gate_required": true,
    "auto_deliver_on_pass": false
  },
  "audit": {
    "enabled": true,
    "log_dir": ".code-toolkit/audit/",
    "retention_days": 365,
    "track_all_changes": true
  }
}
```

### 质量门禁配置
```json
{
  "quality_gates": [
    {
      "name": "测试覆盖率",
      "command": "pytest --cov --cov-fail-under=80",
      "threshold": 80,
      "block_on_fail": true
    },
    {
      "name": "Lint检查",
      "command": "ruff check .",
      "threshold": 0,
      "block_on_fail": true
    },
    {
      "name": "类型检查",
      "command": "mypy src/",
      "threshold": 0,
      "block_on_fail": true
    },
    {
      "name": "安全扫描",
      "command": "bandit -r src/",
      "threshold": 0,
      "block_on_fail": true
    }
  ]
}
```

## 常见问题

### Q1: 专业版是否兼容免费版的工作流?
完全兼容。专业版使用相同的五步开发流程,免费版的偏好记忆可直接使用。

### Q2: 多任务编排最多支持多少并行?
默认最大 5 个并行任务,可通过配置调整。任务间有依赖时会自动按顺序执行。

### Q3: 质量门禁不通过怎么办?
门禁不通过会阻止交付,工具会给出具体的修复建议。修复后重新检查即可。

### Q4: 代码审查如何分配审查者?
默认按轮询策略(round-robin)自动分配,也可配置为按专长分配或手动指定。

### Q5: 审计日志存储在哪里?
默认存储在 `.code-toolkit/audit/` 下,保留 365 天。可配置为其他路径。

### Q6: 如何获得优先技术支持?
专业版用户可通过专属通道提交问题,通常 1 个工作日内响应。

## 错误处理


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

## 已知限制

- 
- 
-