# 客户 AI 工程资产交付包

本包是第五、六天课程配套的正式资产交付物，用于把 AI 编程中的项目理解、约束提取、复杂业务设计、交付 Review 和修复闭环沉淀为可维护的团队资产。

它不包含客户代码、服务地址、账号、令牌、真实业务数据或未经验证的项目结论。所有业务字段、权限码、接口和状态均以占位符表达，使用时必须从目标项目重新取证。

## 交付内容

```text
客户AI工程Skill交付包/
├── README.md
├── 安装说明.md
├── 交付清单.md
├── skills/
│   ├── generate-project-constraints/    # 提取项目规则与约束
│   ├── project-knowledge-builder/       # 建立源码依据的项目知识库
│   ├── design-complex-business-module/  # 设计权限、状态、审计、异常态和指标
│   ├── review-business-delivery/        # 审查业务交付与变更风险
│   └── track-review-fix-loop/           # 跟踪 Review 修复与验证闭环
├── mcp-assets/
│   ├── MCP能力契约.template.md
│   └── MCP工具权限与验收清单.md
└── examples/
    └── jeecgboot-official-vehicle/
        └── 公务用车取消派车案例.md
```

## Skill 列表

| Skill | 解决的问题 | 典型产物 |
|---|---|---|
| `generate-project-constraints` | 从源码、配置、测试和 CI 中提取项目约束 | Rule、约束提取表、验收清单 |
| `project-knowledge-builder` | 建立可追溯、可持续更新的项目知识库 | 项目地图、接口与权限索引、维护指南 |
| `design-complex-business-module` | 设计高风险业务模块的工程边界 | 权限矩阵、状态流转表、审计 SOP、指标字典 |
| `review-business-delivery` | 审查设计、代码或 PR 的业务风险 | Review 报告、风险清单、验收建议 |
| `track-review-fix-loop` | 跟踪问题修复、验证和资产更新 | 修复记录、未闭环清单、资产更新建议 |

## MCP 资产

`mcp-assets/` 只提供能力契约和验收清单，不预置任何 MCP 服务地址、工具配置或凭据。接入外部能力前，必须明确输入输出、数据范围、权限、副作用、失败降级和验证夹具；写入、删除、发布和外发能力不应作为通用 Agent 的默认权限。

## 公务用车案例

`examples/jeecgboot-official-vehicle/` 是基于现有 JeecgBoot 公务用车模块的单人训练案例。它展示如何把“取消派车时取消原因不能为空”的训练改造，转成源码依据、最小改动边界、验证证据和待确认项。

该案例只说明已读取到的项目事实与已执行验证，不代表客户已提出相同业务需求，也不能直接替代目标项目的重新取证。

## 使用边界

- Skill 保存可复用的判断流程，不保存某个项目的路径、字段、接口或权限码。
- Rule、任务上下文契约、检查单、模板、Skill、Agent 和 MCP 职责不同，应保持单一权威位置。
- 任何没有源码、日志、测试或明确规范支持的结论，都要标记为待确认。
- 资产变更应检查行为变化、引用完整性、兼容性、迁移与回退，并使用完整、缺失、冲突和越界输入夹具复核。

安装与团队使用方式见 [安装说明.md](./安装说明.md)，本次正式交付范围见 [交付清单.md](./交付清单.md)。