Code Dev Toolkit

企业级代码开发工作流工具，支持多任务并行编排、团队规范管理、质量门禁、代码审查及CI/CD集成与交付审计。

Install

openclaw skills install @thcjp/code-dev-toolkit

代码开发工具包专业版

核心能力

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使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

Code Dev Toolkit

Install

代码开发工具包专业版

核心能力

1. 多任务并行编排

2. 团队编码规范

3. 质量门禁

4. 代码审查工作流

5. CI/CD 集成

能力覆盖范围

适用场景

场景一: 企业级多功能并行开发

场景二: 团队协作与代码审查

场景三: 持续集成与持续交付

使用流程

优秀步: 初始化项目配置

第二步: 配置团队规范

第三步: 执行编排开发

命令参数说明

命令参数说明

输入格式

输出格式

异常处理

依赖说明

运行环境

依赖说明

API Key 配置

可用性分类

案例展示

企业级配置

质量门禁配置

常见问题

Q1: 专业版是否兼容免费版的工作流?

Q2: 多任务编排最多支持多少并行?

Q3: 质量门禁不通过怎么办?

Q4: 代码审查如何分配审查者?

Q5: 审计日志存储在哪里?

Q6: 如何获得优先技术支持?

错误处理

已知限制