---
name: project-delivery-checklist
description: 把一个 AI/Agent 项目从"本地能跑"推进到"可以交付"时使用：交付前自检清单，覆盖可运行性、评测、安全、文档四个维度。
tags: [checklist, delivery, production]
category: templates
---


# 项目交付前自检清单

每次项目要交给真实用户（或写进简历/面试）之前过一遍。目标：让项目通过 Anthropic 那道筛选题——"是否部署到过生产"。

## 可运行性

- [ ] 一条命令能跑起来（README 里写清，别人 clone 后 10 分钟内跑通）
- [ ] 环境变量有 `.env.example`，不含真实密钥
- [ ] 有最小可复现示例（demo 输入 → 预期输出）

## 评测

- [ ] 有评测集（哪怕 20 条）和评测脚本
- [ ] 有当前版本的基线指标记录
- [ ] 改动 prompt/模型后跑过回归

## 安全

- [ ] API key 不在代码里、不进 git 历史
- [ ] 工具调用最小权限（查询类项目只读）
- [ ] 知道自己的数据边界：哪些数据流到了模型供应商

## 文档与展示

- [ ] README 有架构图（三个组件以内画清楚）
- [ ] 写了"踩坑记录"——这是面试时最值钱的部分
- [ ] 有在线可访问地址（哪怕只是录屏）
- [ ] 部署含认证/监控/日志至少其一