外观
Foundation Goal 协议
目的
Foundation Goal 用于在一个教学日内，把经过 Day 0 预检的 starter repository 收敛为可持续迭代的四端底座。
它不是一个超长 Prompt，也不是让 Codex 自由设计产品。架构事实、任务依赖和完成证据分别由仓库内的 ARCHITECTURE.md、BASELINE.md、TASK_GRAPH.yaml 和 foundation:verify 定义。
Goal 只承担：
- 保持目标跨 turns 存续。
- 按任务依赖选择下一步。
- 在失败后继续调查、修复和重试。
- 依据机械证据判断继续、完成或阻塞。
Starter Repository 最小输入
text
AGENTS.md
README.md
docs/foundation/ARCHITECTURE.md
docs/foundation/BASELINE.md
docs/foundation/TASK_GRAPH.yaml
docs/foundation/DECISIONS.md
contracts/openapi.yaml
contracts/realtime-events.json
scripts/doctor.mjs
scripts/verify-foundation.mjs1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
starter repository 可以预置项目壳、构建配置和教学 fixtures，但不得包含生产 Srome Git 历史、密钥或用户数据。
Goal 的六个组成部分
- Outcome：底座最终必须具备什么状态。
- Verification surface：哪个命令和证据证明完成。
- Constraints：工作过程中什么不能退化。
- Boundaries：允许读取、修改和调用的范围。
- Iteration policy：每次失败后如何选择下一步。
- Blocked stop condition：什么情况下必须停止并请求最小输入。
推荐 Goal
text
/goal 在当前教学仓库中实现 Srome Teaching Foundation v1。
最终状态必须完整满足 docs/foundation/BASELINE.md，并通过
`pnpm foundation:verify` 提供的全部机械验收。
开始前完整读取根 AGENTS.md、README.md、docs/foundation/ 下的架构、
基线、任务图和决策文档，以及 contracts/ 和验证脚本。先只读调查当前
仓库状态，创建并持续更新 Foundation ExecPlan，随后按 TASK_GRAPH 的
依赖顺序实现、编译、测试和修复。
API、Admin、iOS、Android 必须使用同一共享合同。不得跳过失败测试、
伪造通过结果、删除验收、提交密钥、复制生产 Srome 源码或执行发布和
不可逆外部动作。外部凭据缺失时只可使用规格允许的 fake adapter。
每完成一个任务节点，更新执行计划和证据账本；架构变化同步更新
README 和 ARCHITECTURE。每次迭代运行最小相关验证，每个阶段运行阶段
gate，最后从 clean state 运行 `pnpm foundation:verify`。
只有 mandatory gates 全部通过、证据完整且无未解释失败时才可完成。
如果同一 blocker 在现有权限、依赖和规格内无法继续，停止并报告已完成
节点、失败命令、诊断证据、精确 blocker、最小解锁输入和恢复节点。1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
允许自主处理
- 阅读仓库、规格、测试和构建日志。
- 在工作区内创建和修改底座代码。
- 运行无外部破坏性的构建、测试、格式化和本地 smoke。
- 根据失败证据调整实现顺序。
- 更新执行计划、架构文档和证据账本。
必须停下请求输入
- 规格冲突会导致不同产品行为。
- 需要付费账号、真实证书或外部平台审批。
- 需要扩大网络、文件系统或系统权限。
- 需要覆盖已有外部资源、删除数据或发布。
- 验收本身疑似错误，且无法用已有事实消解。
禁止的假完成
- 把 fake adapter 描述成真实外部集成。
- 只运行局部测试便宣称整个底座完成。
- 为了通过测试而删除断言、禁用测试或硬编码 fixture。
- iOS/Android 只编译 library，不启动应用。
- 只创建接口和 TODO，没有真实 walking skeleton。
- 因预算耗尽而把 Goal 标记完成。
Foundation Goal 结束时的输出
- Foundation capability ledger。
- 最终 ExecPlan。
- 结构化 evidence ledger。
- 构建与测试摘要。
- 未完成、近似实现和真实 blocker 清单。
- clean rebuild 结果。
- 当日 Git checkpoint 候选。