项目接管
接管一个项目
第一次进入仓库时,按这个顺序收集事实并留下缺口。
1. 先写 Project Profile
只选项目真正负责的主 Profile:Web Application 或 Platform Service。把明确不负责的事项一起写下,例如账号体系、品牌规则或数据库所有权。
2. 找权威来源
对 API、权限、配置、部署和运行时环境逐项记录 owner 与 location。代码只能证明实现存在,不能自动证明它仍是权威定义。
3. 分开验证
- Code:类型、单元测试、静态规则。
- Contract:请求、响应、错误语义、兼容性。
- Runtime:真实浏览器、环境、依赖和副作用。
4. 记录 Evidence
每条 Evidence 至少包含 source revision、日期、环境、执行动作、预期、实际结果和限制。
5. 再判断能否开工
阻塞项会得到 BLOCKED;未确认项、过期 Evidence 或接受的偏差会得到 WITH EXCEPTIONS;只有当前证据完整且没有 finding 时才是 READY。