跳到主要内容

项目脚手架

核对日期：2026-05-13。

这个目录是一套可复制的综合项目交付骨架，对应阶段 14 的最终项目要求。它不是绑定某个框架的代码模板，而是一套作品集级 AI 项目最小交付结构：先把需求、架构、评测、安全、成本和演示材料搭好，再按项目方向补实现。

1. 适用项目​

适合以下方向：

  • 企业知识库问答系统。
  • 代码库分析 Agent。
  • 客服工单辅助 Agent。
  • 数据分析助手。
  • 研究报告生成系统。
  • 其他具备明确任务、可评测输出和安全边界的 AI 应用。

不适合：

  • 只演示聊天能力的单页 demo。
  • 没有评测集和失败样例的模型调用示例。
  • 高风险自动决策系统，例如自动诊断、自动投资、自动法律结论。

2. 目录结构​

项目脚手架/
├── README.md
├── docs/
│   ├── requirements.md
│   ├── architecture.md
│   ├── evaluation.md
│   ├── security-review.md
│   └── cost-and-ops.md
├── evals/
│   ├── README.md
│   └── eval-cases.sample.jsonl
├── examples/
│   ├── README.md
│   └── demo-script.md
├── prompts/
│   ├── README.md
│   ├── system-prompt.md
│   └── prompt-version-log.md
├── ops/
│   └── README.md
└── src/
    └── README.md

3. 使用方式​

  1. 复制整个 项目脚手架/ 目录到你的实际项目目录。
  2. 先填写 docs/requirements.md，明确用户、任务、MVP、非目标和成功指标。
  3. 再填写 docs/architecture.md，确认数据流、控制流、模型流、权限流和失败回滚路径。
  4. 在写代码前建立 evals/eval-cases.sample.jsonl 的真实版本，至少 30 条样例。
  5. 实现 MVP 后补充 docs/evaluation.md、docs/security-review.md 和 docs/cost-and-ops.md。
  6. 最后整理 examples/demo-script.md，保证演示可复现。

4. 最低完成标准​

交付物最低标准
需求文档用户、任务、MVP、非目标、成功指标明确
架构文档数据流、控制流、模型流、权限和审计清楚
评测集至少 30 条，覆盖正常、边界、拒答、安全、失败回归
安全评审信任边界、数据分类、工具权限、日志脱敏和人工确认明确
成本运营记录 token、延迟、错误、调用成本和发布回滚方案
演示材料有固定输入、期望输出、失败展示和答辩路线

5. 推荐实现路线​

6. 评分提醒​

评审者通常不是只看功能是否跑通，而是看你能不能回答：

  • 为什么这个场景需要 AI。
  • 为什么选择 RAG、Workflow 或 Agent。
  • 如何证明回答质量可靠。
  • 错误输出如何被发现、阻止和回滚。
  • 成本、延迟和安全风险是否可控。