smart
67837df8d0
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
2.4 KiB
2.4 KiB
安装说明
使用前确认
本包不携带外部系统地址、账号、令牌或客户数据。请先在目标项目中确认 AI 工具的 Skill 加载方式、项目规则位置和访问权限，再决定安装范围。
方式一：作为本地 Skill 目录使用
将 skills/ 下需要启用的完整文件夹复制到当前 AI 编程工具配置的本地 Skill 目录。不同版本和不同工具的目录规则可能不同，应以当前客户端实际配置为准。
每个 Skill 必须保留原始目录结构：
skill-name/
├── SKILL.md
├── agents/
│ └── openai.yaml
├── assets/ # 部分 Skill 提供
├── references/ # 部分 Skill 提供
└── scripts/ # 部分 Skill 提供
推荐启用顺序：
generate-project-constraints：先获取项目约束。project-knowledge-builder：建立项目地图和可检索知识。design-complex-business-module：设计权限、状态、审计等高风险边界。review-business-delivery：审查设计、代码或 PR。track-review-fix-loop：跟踪修复、验证与资产更新。
方式二：作为团队资产库使用
如果当前工具不支持原生 Skill 发现，可将本包纳入团队资产库。保留目录结构，并让任务上下文契约或 Agent 明确引用对应文件。
ai-engineering-assets/
├── skills/
├── mcp-assets/
└── examples/
其中 SKILL.md 负责输入、工作流、输出契约和停止条件；assets/ 存放模板、任务上下文契约、检查单和反例；mcp-assets/ 负责外部能力的契约、权限与验收边界。
MCP 资产的使用
- 使用
mcp-assets/MCP能力契约.template.md描述每项待接入能力。 - 使用
mcp-assets/MCP工具权限与验收清单.md审查数据范围、权限、副作用和故障降级。 - 为完整请求、缺参、越权、超时和敏感字段准备验证夹具。
- 只有契约与验证完整后，才把工具授权给对应 Agent。
维护要求
- 项目规则、框架、接口、权限或测试基座变化后，重新取证并更新相关资产。
- 不要将示例中的业务对象、路径、字段、接口、状态或验证结论复制到其他项目。
- 资产变更需要说明行为变化、兼容边界、迁移方式、回退条件和验证证据。
- 对无法证明的内容保留为待确认，不以经验或模型建议替代事实。