AI 治理
VUP 把 AI 交付当作工程系统，而不是黑盒生成。
核心原则
- 标准化输入：先定义规则与 skills，再执行任务。
- 标准化过程：分阶段推进，关键节点显式确认。
- 标准化输出：结构、命名、改动范围可复查。
Core 指令与扩展
AI 协作由 .agents 目录驱动：
_core/rules/：始终生效的硬规则，约束流程、文件、模块和质量。_core/tasks/：按工程动作加载的任务卡片，例如添加应用、页面、接口、鉴权和发布。_core/stacks/：只在任务需要时读取的平台差异说明。- 外部 skill：由各自安装器管理，不写入
.agents。
项目需要 AI 协作时，执行：
bash
vup skill init
vup skill addvup skill init 复制项目指令资产，例如 _core/ 和 project.md。vup skill add 使用模板仓库中仅作为模板存在的 ai.md 和 .aiignore 生成客户端入口文件，例如 AGENTS.md、CLAUDE.md 和 .cursorignore。
Core 指令分层：
- Rules 定义不可突破的边界。
- Tasks 描述 AI 如何执行一个工程动作。
- Stacks 解释平台差异，但不写成框架教程。
- 外部 skill 补充团队领域知识或项目偏好，但不修改
.agents。
Packages 与 Skills
Packages 是通过 vup package add 安装的运行时能力；skills/tasks 不替代 packages，而是告诉 AI 什么时候选择某个 package、应该接到哪个 app 位置、以及要遵循哪个 package README 或 API。
例如，当任务判断 Vue 应用需要接入请求层时，会读取对应 task 和 stack 说明，然后优先使用 packages/http 里的 @vup/http，而不是重新手写一套请求层。
Hard Gate（关键停顿确认）
在高影响步骤，AI 必须先停下并请求确认，再继续执行。常见 Gate 包括：
- 多阶段流程进入下一阶段
- 存在歧义时的方案选择
- 新增依赖或结构性重构
- commit / publish 操作
这样可以保证关键决策可见、可追踪，而不是隐式推进。
skills 如何匹配任务
- 先根据任务意图匹配
_core/tasks/*。 - 仅加载必要 task 和 stack 说明，同时保持 rules 全程生效。
- 按阶段执行并在 Gate 节点请求确认。
为什么更可靠
| 维度 | 通用 AI 生成 | VUP 治理 |
|---|---|---|
| 输入 | 主要依赖提示词，容易漂移 | rules + skills + 仓库约定 |
| 过程 | 中间步骤不透明 | 分阶段推进，关键节点确认 |
| 输出 | 每次风格波动大 | 结构和规范一致性更高 |
| 团队协作 | 难复用、难对齐 | 共享约定，可持续复用 |
实际落地方式
- 先通过
vup app add搭建应用模板。 - 让 AI 在 rules + skills 约束下执行任务。
- 用
vup package add按需后补能力。 - 需要单能力参考时用
vup example add添加示例工程。 - 全流程保持可追踪、可评审。