Skill: clawaizhang/code-dev-pipeline (version 1.0.0)

--- name: code-dev-pipeline description: | 八人协作代码开发流水线，用于复杂代码开发任务。**必须使用此 skill 当用户要求开发代码、写程序、实现功能，或对代码质量有要求时**。特别适合： - 复杂功能开发（>50行代码、多文件、需要测试） - 需要UI/前端设计的项目（HTML/CSS/JS、React/Vue等） - 对代码质量有要求的任务（需要审查、测试、文档） - 关键/策略性代码（需要多人把关） - 用户不想中间确认、只想看最终结果 **八人角色**：Coordinator（协调员）、Analyst（需求分析）、Architect（架构设计）、UIDesigner（UI设计）、Coder（代码编写）、Reviewer（代码审查）、Tester（测试验证）、Validator（最终验收）。 **三种模式**：完整模式（全流程）、快速模式（精简流程）、维护模式（紧急修复）。 触发词：开发代码、写程序、实现功能、代码流水线、复杂开发、需要测试的代码、前端开发、UI设计、网页开发 --- # 代码开发流水线 v2.2（八人协作版） 八人协作的专业化代码开发流程，**支持前端/UI设计环节**，有限迭代闭环，全自动执行。 --- ## 快速判断 | 场景 | 使用此 skill | 直接写代码 | |------|-------------|-----------| | 复杂功能（>50行、多文件） | ✅ **必须使用** | ❌ 不适用 | | 需要前端/UI设计 | ✅ **必须使用** | ❌ 不适用 | | 需要测试覆盖 | ✅ **必须使用** | ❌ 不适用 | | 关键/策略性代码 | ✅ **必须使用** | ❌ 不适用 | | 用户不想中间确认 | ✅ **适合使用** | ⚠️ 可协商 | | 简单脚本（<50行） | ❌ 不适用 | ✅ 直接写 | | 一次性快速验证 | ❌ 不适用 | ✅ 直接写 | | 纯后端API无界面 | ✅ 使用（跳过UI Designer） | ⚠️ 可协商 | --- ## 项目类型判断 ``` 需求包含前端页面? ──是──→ 启用 UI Designer │否 ↓ 跳过 UI Designer 环节 ``` **前端项目特征**： - 涉及 HTML/CSS/JavaScript - React/Vue/Angular 等前端框架 - 需要用户界面设计 - 移动端H5页面 - 管理后台界面 - 任何需要视觉呈现的代码 --- ## 角色配置模式 | 模式 | 适用场景 | 启用角色 | 预算 | |-----|---------|---------|------| | **完整模式** | 新功能开发、重大变更、前端项目 | 全部8角色 | 5次 | | **快速模式** | 小型优化、文档更新 | Analyst+Architect合并，Tester+Validator合并，UI Designer按需 | 3次 | | **维护模式** | 紧急Bug修复 | Coordinator+Coder+Tester+Validator（跳过UI/分析） | 2次 | ### 模式选择 ``` 紧急Bug修复? ──是──→ 维护模式 │否 ↓ 新功能/重大变更? ──是──→ 完整模式 │否 ↓ 快速模式 ``` --- ## 工作流程 ### 标准流程（非前端项目） ``` 用户/环境反馈 ↓ [Coordinator] 生成迭代需求单（确定模式、预算、MoSCoW优先级） ↓ [Analyst] 需求文档（快速/维护模式可跳过） ↓ [Architect] 架构方案（含日志规范、非功能需求） ↓ [Coder] 编码并自测（含日志埋点、环境配置） ↓ [Reviewer] 代码审查 ←──────┐ ↓ 通过 │ 不通过（预算内） ↓ │ [Coder] 修改 ──────────────┘ ↓ [Tester] 测试验证 ←────────┐ ↓ 通过 │ 发现bug（预算内） ↓ │ [Coder] 修复 ──────────────┘ ↓ [Validator] 最终验收 ←─────┐ ↓ 通过 │ 不通过（预算内） ↓ │ [Coder] 调整 ──────────────┘ ↓ Validator 输出验收报告（含技术债务清单） ↓ 报告回到 Coordinator，更新基线，决策下一轮 ``` ### 前端项目流程（启用UI Designer） ``` 用户/环境反馈 ↓ [Coordinator] 生成迭代需求单（确定模式、预算、MoSCoW优先级，标记前端项目） ↓ [Analyst] 需求文档（包含交互需求、用户流程） ↓ [Architect] 架构方案（含技术栈、组件选型、日志规范、非功能需求） ↓ [UIDesigner] UI/UX设计（使用 ui-ux-pro-max skill） ↓ [Coder] 编码并自测（按设计稿实现，含日志埋点、环境配置） ↓ [Reviewer] 代码审查 ←──────┐ ↓ 通过 │ 不通过（预算内） ↓ │ [Coder] 修改 ──────────────┘ ↓ [Tester] 测试验证 ←────────┐ ↓ 通过 │ 发现bug（预算内） ↓ │ [Coder] 修复 ──────────────┘ ↓ [Validator] 最终验收 ←─────┐ ↓ 通过 │ 不通过（预算内） ↓ │ [Coder] 调整 ──────────────┘ ↓ Validator 输出验收报告（含技术债务清单） ↓ 报告回到 Coordinator，更新基线，决策下一轮 ``` ### 迭代预算制 - **默认预算**：完整5次 / 快速3次 / 维护2次 - **动态调整**：Coordinator 可按时间设定（如"2小时内"） - **超预算**：标记为技术债务，继续流程但记录风险 - **UI设计环节**：如需 redesign，从 UI Designer 重新开始，消耗1次预算 --- ## 八角色定义 ### 【1】Coordinator（协调员） **职责**：监听输入，决策优先级，确定模式与预算，生成迭代需求单，管理知识库，维护版本基线。 **决策参考**（MoSCoW）： - Must have - 必须有 - Should have - 应该有 - Could have - 可以有 - Won't have - 不会有 **前端项目识别**： - 检查需求是否包含：页面、界面、UI、HTML、CSS、React、Vue、Angular、H5等关键词 - 向用户确认："这个项目需要前端页面/UI设计吗？" - 在迭代需求单中标记：`frontend_project: true/false` **输出**：迭代需求单、版本基线记录 --- ### 【2】Analyst（需求分析师） **职责**：理解需求，转化为结构化文档，识别边界条件。 **前端项目特殊要求**： - 明确用户交互流程 - 定义关键页面和跳转逻辑 - 列出需要设计的界面清单 - 确定响应式/多端适配需求 **输出**：需求规格说明书（功能需求 FR、边界条件 EC、验收标准、界面清单） --- ### 【3】Architect（架构师） **职责**：设计架构，选择技术栈，定义模块接口，制定日志规范和非功能需求。 **前端项目特殊要求**： - 推荐前端框架（React/Vue/Angular/原生） - 确定UI组件库（Ant Design/Element/Material等） - 定义前后端接口规范 - 确定状态管理方案 **日志规范**： - 必须记录：对外接口调用（输入/输出/耗时）、核心业务逻辑（状态变化）、错误异常 - 日志级别：ERROR/WARN/INFO/DEBUG - 禁止：每行代码都打日志、循环内打DEBUG、记录敏感信息 **非功能需求**： - 性能指标（响应时间、并发量、首屏加载时间） - 安全要求（输入验证、SQL注入防护、XSS防护、CSRF防护） - 可扩展性、浏览器兼容性 **输出**：架构设计文档（含前端技术选型说明） --- ### 【4】UIDesigner（UI设计师）⭐ 新增 **触发条件**：前端项目（`frontend_project: true`） **职责**：使用 `ui-ux-pro-max` skill 进行界面设计，输出设计规范和原型。 **工作流程**： 1. 读取 Analyst 的需求文档和界面清单 2. 读取 Architect 的技术选型（确定设计约束） 3. 使用 `ui-ux-pro-max` skill 进行设计 4. 输出设计交付物 **设计范围**： - 页面布局和视觉设计 - 组件设计规范（颜色、字体、间距、圆角等） - 交互流程和动效说明 - 响应式适配方案 - 设计系统（Design System） **输出**： - UI设计稿（文字描述或HTML原型） - 设计规范文档（颜色、字体、组件规范） - 交互说明文档 **与 Coder 的协作**： - Coder 必须按设计稿实现 - 实现偏差需与 UI Designer 确认 - UI Designer 可要求调整（预算内） --- ### 【5】Coder（代码编写员） **职责**：按架构和设计实现代码，日志埋点，自测，环境复现配置。 **前端项目特殊要求**： - 严格按照 UI Designer 的设计稿实现 - 确保像素级还原设计（颜色、间距、字体一致） - 实现响应式布局和动画效果 - 自测浏览器兼容性 **自测要求**： - 运行至少一个 Happy Path 场景 - 前端项目：在至少2种浏览器中测试 - **必须编写单元测试，覆盖率须达到 80% 以上**（未达到需补充测试或提供理由） - 记录运行命令、日志摘要、测试结果、覆盖率报告 **环境复现**： - 依赖文件（requirements.txt, package.json） - 运行命令 - 环境变量说明 - 不强制容器化 **输出**：完整代码、自测说明、环境配置、单元测试覆盖率报告 --- ### 【6】Reviewer（代码审查员） **职责**：需求覆盖检查、架构符合性、代码质量、日志审查、非功能设计审查、**单元测试覆盖率审查**。 **前端项目特殊要求**： - 检查UI还原度（与设计稿对比） - 检查组件化实现 - 检查CSS规范（BEM命名、避免全局污染） - 检查响应式实现 **审查要点**： - 需求覆盖：所有 Must have 需求已实现 - 架构符合：符合 Architect 定义的架构方案 - 代码质量：可读性、命名规范、复杂度控制 - 日志审查：符合日志规范（关键路径有日志，无冗余日志） - 非功能需求：符合 Architect 定义的非功能需求 - **单元测试覆盖率：必须达到 80% 以上，否则不通过** **输出格式**： ``` 【通过】或【不通过】 - {问题类型}: {位置} - {建议} ``` **覆盖率不达标示例**： ``` 【不通过】 - 单元测试覆盖率不足: src/utils.py - 当前覆盖率 65%，需补充边界条件测试用例 ``` --- ### 【7】Tester（测试验证员） **职责**：设计测试用例（正常+异常），功能测试，日志验证，非功能测试（抽样）。 **前端项目特殊要求**： - 跨浏览器测试（Chrome/Firefox/Safari至少2种） - 响应式测试（桌面端/平板/手机） - 交互流程测试 - 视觉回归测试（与设计稿对比） **输出格式**： ``` 【通过】或【发现bug】 - 用例执行情况 - 日志验证结果 - Bug描述及复现步骤 - 浏览器兼容性结果 ``` --- ### 【8】Validator（最终验收员） **职责**：完整性检查，功能验收，日志抽查，非功能验收，风险评估。 **前端项目特殊要求**： - 最终UI还原度确认 - 用户体验走查 - 性能指标验证（首屏加载时间等） **输出格式**： ``` 【通过】或【不通过】 - 需求覆盖情况 - 验收测试摘要 - 技术债务清单 - UI还原度评估 ``` --- ## 关键设计要点 1. **Coder 是核心枢纽** - 接收三方反馈（Reviewer、Tester、Validator），在预算内修改 2. **UI Designer 是前端项目的关键路径** - 设计质量直接影响最终产品体验 3. **明确通过/不通过标记** - Reviewer/Tester/Validator 第一行必须是【通过】或【不通过】/【发现bug】 4. **结构化打回反馈** - 必须附带问题类型、位置、建议 5. **日志规范与验证** - Architect 定义，Coder 实现，Reviewer 审查，Tester/Validator 验证 6. **非功能需求贯穿全程** - Architect 定义，Reviewer 审查，Tester 测试，Validator 验收 7. **迭代历史全保留** - 最终报告包含所有轮次记录 8. **超预算标记技术债务** - 继续流程但记录风险，由 Coordinator 纳入后续计划 9. **知识库与版本管理** - 所有产出存入知识库，Coordinator 维护版本基线 10. **前端项目设计先行** - UI Designer 必须在 Coder 之前完成设计 --- ## 最终产出 **必须保留**： 1. 最终代码（附自测说明和环境配置） 2. 单元测试及覆盖率报告（覆盖率须 ≥80%） 3. 最终验收报告（含技术债务清单） **前端项目额外产出**： 4. UI设计稿和规范文档 5. 浏览器兼容性报告 **建议保留**（可合并/增量更新）： - 需求规格说明书 - 架构设计文档 - UI设计文档（前端项目） - 代码审查报告 - 测试验证报告 - 技术债务清单 --- ## 使用 ui-ux-pro-max skill 当启用 UI Designer 角色时，按照以下方式使用 `ui-ux-pro-max` skill： ``` 1. 确保 ui-ux-pro-max skill 已安装 2. UI Designer 读取需求文档和界面清单 3. 调用 ui-ux-pro-max 进行设计 4. 输出设计稿和规范文档 5. 将设计交付物传递给 Coder ``` **设计交付物格式**： - 文字描述型设计说明 - HTML/CSS 原型代码 - 组件使用规范 - 响应式断点定义 --- ## 版本历史 - **v2.3**：新增单元测试覆盖率硬性要求（Coder/Reviewer 须确保 ≥80%） - **v2.2**：新增 UI Designer 角色，支持前端项目UI设计环节 - **v2.1**：整合 v1.2 特性，精简为 OpenClaw skill 格式 - **v1.2**：有限迭代版，角色配置灵活性、迭代预算制、日志细化、非功能验证、MoSCoW 决策 - **v1.1**：新增 Coordinator，形成闭环 - **v1.0**：初始版本，六角色串行


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)