本地项目上下文
本地项目上下文是 Lite 的基础。它不是把所有文件都交给 AI,而是先告诉 AI:项目是什么、应该先读哪里、本次能改哪里、哪些资料不能进入任务、完成后怎样验证。
上下文包含什么
| 内容 | 写清楚什么 |
|---|---|
| 项目身份 | 项目做什么、给谁用、当前阶段。 |
| 主要目录 | 源码、文档、配置、脚本和测试分别在哪里。 |
| 运行方式 | 本地启动、依赖安装、环境限制和已知问题。 |
| 检查方式 | 测试、类型检查、构建或人工验收方式。 |
| 本次范围 | 当前任务允许读取和修改的目录。 |
| 禁止范围 | 密钥、客户资料、本机配置、生产配置、未脱敏日志。 |
最小模板
text
项目身份:
当前阶段:
主要目录:
本次任务相关目录:
启动命令:
检查命令:
允许 AI 读取:
禁止 AI 读取:
完成后必须说明:好上下文的标准
- AI 能知道第一步应该读哪个入口。
- 任务范围不会扩散到无关模块。
- 本机资料和公开资料分得清楚。
- 验证方式能执行,或能说明未配置原因。
- 下一次任务可以复用,不需要重新解释一遍。
常见错误
| 错误 | 后果 |
|---|---|
| 只说“这是我的项目” | 项目目标和当前阶段没有进入上下文。 |
| 只贴一堆文件 | AI 很容易错过任务边界。 |
| 不写禁止范围 | 本机资料、密钥或无关模块可能被带入任务。 |
| 不写验证方式 | 完成后无法判断结果是否可信。 |
下一步
整理完上下文后,继续做 项目健康,把已知风险和缺口留给后续任务。
