Vibecoding · 需求与上下文
从模糊想法到仓库上下文与可验收规格
让 AI 开发前先读项目规则、现有结构和真实边界，再把对话变成可检查的规格。
本页目录
学完这一篇，你应该能够
- 为仓库建立清楚的工作入口
- 把需求写成行为与验收
- 控制改动范围和未知项
项目规则是开发任务的系统上下文
AGENTS.md、CLAUDE.md 或项目说明可以告诉 AI 怎样启动、测试、组织文件和保护数据。规则要短、真实、可执行；过期说明比没有说明更危险。
先读现状，再决定改哪里
修改前应检查入口文件、相关组件、数据流、测试和运行方式。不要为了使用熟悉模板而替换一个已经工作的架构，也不要把无关重构混进功能修改。
PRD 或 Issue 要写可观察行为
规格应说明谁在什么情况下做什么、系统怎样响应、失败时发生什么，以及什么证据代表通过。未知信息应记录为假设或待确认项。
- 范围内与范围外
- 正常路径与边界路径
- 数据和权限限制
- 验收步骤与预期结果
- 需要保留的旧行为
动手练习
把上一课的小工具写成一页规格，包含范围、三条用户行为、两个异常情况、五条验收标准和一个明确不做的功能。
完成标准
- AI 能从项目入口找到运行与测试方式
- 规格描述行为而非模糊形容词
- 无关改动被明确排除
资料说明
根据 PandaUp 资料中的开放式开发流程、课件生成脚本与脱敏 Agent 工程案例重新编写。本文讲解可迁移的方法，不公开内部数据、个人记忆、真实票据或第三方受限内容。