VibeCoding Start
使用这个技能让 Codex 从一开始就拥有一个轻量级工程系统,贯穿项目从首次会话到发布与观测的整个过程。其目标是一个后续会话能够理解、审查、验证、接受,并安全地继续开发,而无需重播整个聊天记录。
第一步操作
阅读项目的 AGENTS.md,然后按照以下热上下文顺序执行:
docs/INDEX.mddocs/CURRENT.mddocs/PRODUCT.mddocs/PRD.mddocs/ACCEPTANCE.md
仅在任务需要时才读取 docs/CODEMAP.md、活跃的 ADR、计划、工作日志、标准以及本地原始证据。如果这六个文档的骨架缺失,请在实现之前先用配套的 vibecoding-project-knowledge 技能的 INIT 模式。
不可妥协的项目边界
- 每个项目都必须拥有相同的最小骨架:
AGENTS.md、docs/INDEX.md、PRODUCT.md、PRD.md、ACCEPTANCE.md、CURRENT.md和CODEMAP.md。 - 复杂性的变化只会改变文档的深度和关卡强度,但不会移除骨架。
PRODUCT.md解释“为什么”,PRD.md解释“是什么”,ACCEPTANCE.md解释“如何证明”。不要将这些职责合并而不加区分。- 当会话改变了需求、功能、非目标、约束或有意义的用户场景时,更新
PRD.md。 - 默认将原始会话、日志、失败的尝试、调查和证据保存在本地的
.project-memory/目录下。只将经过筛选和刻意策划的示例提升到docs/examples/。 - 优先使用现有的项目能力、标准库、官方 SDK/API/工具、成熟的开源项目、包、适配器或组合,然后再考虑自定义基础设施。
- 不要在本工作流中构建内存数据库、向量数据库、搜索引擎、测试框架、部署框架、CI 服务或可观测性后端。
工程关卡
对每个项目使用相同的词汇表,同时根据风险调整深度:
G0 范围
→ G1 意图
→ G2 复用
→ G3 计划
→ G4 构建
→ G5 对抗性评审
→ G6 验证
→ G7 人工验收
→ G8 发布
→ G9 观测
G0 范围
将工作分类为应用程序/产品、集成/适配器或基础设施/安全/运行时。越接近基础设施,复用、审查和恢复证据就必须越强。
G1 意图
使链条变得明确:
PRODUCT(为什么)→ PRD(是什么)→ ACCEPTANCE(如何证明)
在实现之前记录问题、用户、当前和期望状态、功能需求、非目标、约束、验收标准和风险。
G2 复用
对于任何非平凡的一般性能力,在构建之前先搜索,并按以下顺序做出决定:
使用 → 适配 → 组合 → 构建 → 停止
如果选择了“构建”,则在 ADR 中记录已搜索的替代方案、被拒绝的复用路径、维护责任以及所有者的验收方法。模型能编写代码并不能证明自定义代码是正确的选择。
G3 计划
将复杂工作分解为小的里程碑,每个里程碑后都有一个验证点。当范围、架构或风险发生实质性变化时,停下来重新计划。
G4 构建
保持实现小而可逆。使用现有工具链,避免投机性的抽象、依赖和基础设施。
G5 对抗性评审
由独立的评审者检查 PRODUCT.md、PRD.md、ACCEPTANCE.md、活跃决策、相关结构、差异以及测试。查找遗漏、错误假设、回归、重复的能力、过度设计、安全/数据风险、测试空白和回滚失败。重要变更的作者不能是最终评审者。
G6 验证
根据风险比例覆盖正常路径、错误路径、边界路径、无效输入路径、回归路径和恢复路径。提供机器证据和所有者可读的解释;绿色勾号只能证明它实际检查的不变量。
G7 人工验收
所有者确认结果是预期的产品,且其可观察的行为是可理解的。自动化检查和独立评审不能替代此步骤。
G8 发布
在真正使用之前记录版本、最后已知的良好状态、发布说明、备份、回滚方法、迁移风险以及精确的发布目标。
G9 观测
发布后,观察健康状况和用户证据。仅在健康时继续;当证据显示存在问题则停止并回滚或向前推进。根据情况将结果反馈到测试、工作日志、ADR、产品意图、验收或事后分析中。
知识收尾
在每个实质性会话结束时,使用配套的 vibecoding-project-knowledge 技能的 UPDATE 模式:
- 将原始会话细节和大输出保留在本地的
.project-memory/目录中。 - 整理
CURRENT.md和相关的活跃文档。 - 当结构变化时更新
CODEMAP.md。 - 当需求、功能、非目标、约束或用户场景发生变化时更新
PRD.md。 - 在 ADR 中记录重要的选择。
- 更新索引和工作日志。
- 运行相关的确定性审计。
在没有机器证据、人类可读的解释以及所有者的验收方法之前,不要声称完成。
参考资料
- 阅读 标准 v1.3 了解规范规则和发布边界。
- 阅读配套的
vibecoding-project-knowledge技能了解INIT、UPDATE或AUDIT流程。