指南
💡 全站搜索
按 Ctrl + K（macOS 为 ⌘ + K）唤起搜索框，支持中文关键词检索全站标题与正文。
欢迎来到 AGILE TEAM 工程体系文档——金恒科技 共享技术中心联合信息化中心交付团队的 AI 工程化实践知识库。
本站服务于团队各角色成员，涵盖前端、后端、测试、产品、运维等，系统化整理 AI 辅助研发 过程中沉淀的标准流程、规范约定、技能包与最佳实践。欢迎您的建议、批评与指正，也诚邀您的参与和贡献。
站点地图
🚀 快速上手
应用上手第一站，快速跑通开发环境。
前端 → 快速上手 — 环境搭建、VSCode 配置、项目结构、11 篇规范详解、提交规范；日常用法见 Skills 使用指南。
后端 → 快速上手 — 环境准备、契约生成三段式、数据库变更流程、常见问题。
📦 五包工程能力
五个 npm 包覆盖设计 → 前端 → 视觉 → 后端 → 测试全链路，契约同源、独立安装。
| 包 | 版本 | 定位 | 文档 | 安装 |
|---|---|---|---|---|
wl-skills-design | v0.11.1 | 需求设计：流程图 / 说明书 / 原型标注 / 数据库 / 接口 / 评审 | 产品设计 Skills | npx @agile-team/wl-skills-design |
wl-skills-kit | v2.21.0 | 前端 PC：页面生成 / 规范审计 / 菜单字典权限同步 / 场景渲染 | 前端 PC Skills | npx @agile-team/wl-skills-kit |
wl-skills-ui | v1.12.0 | 视觉一致：设计令牌 / 扫描修复 / 运行时守护 / 页面契约 | UI 统一规范 | npx @agile-team/wl-skills-ui |
wl-skills-bd | v0.26.0 | 后端：契约驱动生成 / 数据治理 / 质量门 / 变更审查 | 后端 Skills | npx @agile-team/wl-skills-bd |
wl-skills-test | v0.25.0 | 测试：用例生成 / 深度执行 / 统一报告 / 质量门 | 测试工程 Skills | npx @agile-team/wl-skills-test |
按场景选包：
| 你要做的事 | 用这个包 |
|---|---|
| 从需求/原型产出设计文档（流程图/说明书/数据库/接口） | wl-skills-design |
| 写 PC 端页面、同步菜单字典权限 | wl-skills-kit |
| 统一视觉、扫描修复 UI 偏差 | wl-skills-ui |
| 写后端微服务、管数据库变更 | wl-skills-bd |
| 生成用例、跑自动化、出测试报告 | wl-skills-test |
配套工具：工程脚手架 jh4j-cloud-cli（PC / 移动端 H5 模板一键创建）。
五包之外，团队在 @agile-team scope 下还维护 MachTable 企业数据表格（16 万月下载、28 个外部依赖方）、五编辑器标准化配置、多栈脚手架等 14 个 npm 包——完整索引与选型见 工程生态。
五包协作链路与各自产出物（契约同源，下游消费上游）：
产品/设计 前端开发 前端开发 后端开发 测试工程师
│ │ │ │ │
▼ ▼ ▼ ▼ ▼
wl-skills-design ──► wl-skills-kit ──► wl-skills-ui wl-skills-bd ──► wl-skills-test
流程图/说明书/原型 页面/菜单/权限 视觉统一/扫描修复 代码/DDL/质量门 用例/执行/报告
│ │ │ │
│ page-spec / api.md wl-contract.json 消费契约生成用例
└───────────────────┴──────── 契约同源（jh4j3-openapi3@1.0）───────────┴───────────────────┘🎯 任务直达
按"我现在要做的事"找入口，不用先读完文档。
| 任务 | 直达 |
|---|---|
| 新项目起架子 | 脚手架创建 → 前端快速上手 或 后端快速上手 |
| 从原型/说明书生成一个 PC 页面 | prototype-scan → page-codegen |
| 提测/提交前自查 | kit validate（CLI）· bd validate + review run（使用指南）· test gate（质量门） |
| 存量项目体检 | kit validate（前端）· bd validate + db drift（后端）· test audit（测试脚本） |
| 客户环境迁移 | kit / bd 环境标准化（scan → plan → apply → verify） |
| 页面视觉对齐 | wl-skills-ui 扫描与修复 |
| 出测试报告 | test report / gate |
| 组织一次宣贯 | 宣贯方案 |
🤖 AI 最佳实践
按能力层级，循序渐进掌握 AI 辅助开发。完整层级详解见 AI 最佳实践总览；与部门人员定级（L0-L5）的映射见 成熟度对照。
| 层级 | 内容 | 状态 |
|---|---|---|
| L0氛围编程 | 纯对话驱动，了解边界 | 了解边界 |
| L1提示词工程 | 规范注入 + 上下文压缩 + 一致性保持 | ✅ 已实现 |
| L2Skill | 13 个触发词驱动的结构化技能文件 | ✅ 已实现 |
| L3MCP 工具调用 | 29 个 Tool，菜单/字典/权限/项目感知/快照蓝图/环境标准化全覆盖 | ✅ 已实现 |
| L4CLI | 18 条命令，覆盖安装/校验/修复/契约/场景渲染全生命周期 | ✅ 已实现 |
| L5Agent Pipeline | Skill 链式自动触发，_pipeline.md 协议已落地 | 🟡 践行中 |
| L6Multi-Agent 协同 | 专家 Agent 分工 + 并发处理 | ▶ 近期目标 |
| L7自演化体系 | 高质量产出反哺规范，正向飞轮 | 🔭 终极形态 |
💻 前端
按端拆分，每端包含概览、规范、Skills 集合。
- PC 端 — 概览 & 技术选型 · 架构设计 · 扩展规范 · Skills 集合 · 使用指南
- 移动端 H5 — 概览 & 技术选型 · 扩展规范 · Skills 集合 · 使用指南 · @robot-h5/core
- 移动端 uniApp（基座） — 概览 & 技术选型 · H5 子应用集成 · 钉钉集成 · App 集成与发布 · 消息中心
⚙️ 后端
🧪 测试
测试工程 Skills — 真实执行引擎包：深度接口测试（DAG + 四层断言）、工程级 Playwright、JMeter 压测、test-reports 统一报告与 gate 质量门。快速上手 · 测试规范 · 度量与质量门 · 使用指南。
📋 产品 & 需求
产品设计 Skills — 流程图、需求说明书（IPO 按钮级颗粒度）、原型标注（D1–D3）、数据库/接口设计、术语词典、变更影响、集成评审；
verifyCLI 四域机械校验。原型标注实战。
🔧 运维 & DevOps
独立页面规划中；以下能力已可直接使用：
- CI 质量门：test
gate（审计 + e2e-check + DI + 性能基线，任一失败阻断）· bdreview run（规则 + 基线 + 豁免 + 覆盖率） - 提交规范：Git 分支 & 提交规范（commitlint + husky，前后端通用）
- 环境体检：各包
doctor命令（kit / bd / test 安装即带） - 环境迁移：kit / bd standard-env（scan → plan → apply → verify）
🔄 AI 工作流
AI 工作流 — AI 驱动的全流程工程化实践，从原型设计到测试交付。
📣 宣贯方案
五包落地宣贯文档 — 每包一份：能力全景、痛点场景、接入流程、验收清单与会议输出，可直接用于项目组宣贯。
我该从哪里开始？
| 你是… | 推荐路径 | 预计耗时 |
|---|---|---|
| 新人入职（前端） | 快速上手 → PC 架构设计 → Skills 集合 | 1 天 |
| 移动端开发 | 快速上手 → H5 概览 → 基座集成 → @robot-h5/core | 半天 |
| 新人入职（后端） | 后端快速上手 → 后端 Skills → 使用指南 | 1 天 |
| 测试工程师 | 测试工程 Skills → 使用指南 → AI 最佳实践 | 半天 |
| 产品经理 | 产品设计 Skills → 原型标注 → AI 工作流 | 半天 |
| DBA / 运维 | 数据库变更流程 → 变更审查 review | 1 小时 |
| 想用 AI 提效 | AI 最佳实践 → AI 工作流 | 按需 |
术语速查
文档里反复出现的缩写与黑话（点击展开）
| 术语 | 含义 |
|---|---|
| K1~K19 | wl-skills-kit 的确定性审计规则（v2.18.0 前为 R 前缀） |
| R001~R043 | wl-skills-ui 扫描器的 UI 风格规则（与 kit 的 K 系编号解耦） |
| B1~B31 | wl-skills-bd 后端确定性扫描规则 |
| T1~T25 | wl-skills-test 测试资产审计规则 |
| J1~J8 | bd 的 Java 质量门（ArchUnit/Checkstyle/PMD/SpotBugs/Spotless/P3C/OpenAPI/JaCoCo） |
| DI | Defect Index，缺陷密度质量指标（test 包上线判定 4 指标之一） |
| planHash | bd 生成/写库计划的 SHA-256 指纹，apply 必须回传确认，防计划漂移 |
| W1 | kit 的字节级防漂移校验：scenarioRef 页面手改产物在 CI 即被拦截 |
| profile | 交付口径快照（后端 jh4j3-openapi3@1.0）或 UI 能力档位（native-element 等），按上下文理解 |
| page-spec / wl-contract | kit / bd 的机器契约文件，用例与代码从契约生成而非人工转录 |
| 四方对账 | bd 数据库治理：需求文档 ↔ 契约 ↔ Flyway ↔ 线上快照 逐项对齐 |
| gate | test 包一键聚合质量门：审计 + e2e-check + DI + 性能基线，任一失败阻断 |
| doctor | 各包自带的环境体检命令 |
联系我们
- 团队内部沟通：飞书（工程化实践群 / 各包维护者见对应文档页首作者标签）
- 评论区留言：页面底部 Waline 评论区
- 问题反馈：按各包宣贯文档的反馈模板提供版本、场景与复现样例