---
name: vibe-coding-delivery
description: 将产品想法转为可验证的 MVP，并通过小任务开发、逐步验证和项目文档保持 AI 编程过程可控。适用于 Vibe Coding、从零做产品、推进 MVP、接管已有项目或整理 AI 开发上下文；单独的语法问答和简单代码修正无需套用完整流程。
---

# Vibe Coding 项目交付

把想法、需求、方案、实现和验证串成可追踪的交付过程。交付速度要与验证能力匹配：每个小任务完成后验证，再推进依赖它的任务。

复杂阶段要明确四件事：本步产出、AI 执行内容、用户需要决定或验收的内容、完成标准。已确定的分工无需重复陈述。

## 先判断从哪里开始

- **只有想法**：先收敛目标用户、核心问题和使用场景，再形成 MVP 范围。
- **已有明确需求**：复用已确定内容，从缺失的方案、任务拆解或实现开始。
- **已有项目继续开发**：先读项目指令、相关文档和实际代码，核实当前状态，再做用户要求的增量。涉及项目接管或文档维护时，读取 [project-docs.md](references/project-docs.md)。
- **只要求分析、规划或接管**：交付对应结果即可。用户已经要求实现或修复时，按授权范围继续执行，不为每个阶段重复索要确认。

小改动可把需求、方案、验证压缩成几句话；复杂项目才维护分阶段产出。不要为了走流程重写已有项目或补齐整套文档。

## 1. 收敛需求和 MVP

先尝试从已有信息回答这些问题，仅追问会改变核心行为、范围或成本的缺口：

1. 谁在什么场景遇到什么问题？现在如何处理？
2. 最优先验证的用户价值是什么？
3. 用户经过哪些操作，看到什么结果才算成功？
4. 这一版必须包含什么、明确暂缓什么？
5. 平台、现有技术、数据来源和外部服务有哪些实际约束？

用一句话定位：**为［目标用户］在［场景］提供［核心能力］，帮助其获得［可观察的结果］。**

将 MVP 收敛到一条主要用户路径，通常用 3–5 步描述。一个核心目标可以包含多个必要子功能；删除其中任何一步都会使路径断开的内容，不应被机械地删成“只留一个按钮”。

方向或可行性仍不清楚时，可利用用户提供的竞品、原型或业务流程判断，必要时先做最小流程实验。区分资料所述、实际体验和推测；已有明确需求时不额外开展整套调研。

界面结构和交互规则分开写：页面中有什么控件；用户如何触发、系统如何响应；加载、空数据和失败时如何呈现。只在涉及 AI 时补充其适合承担的任务、输入输出、服务接入和失败表现。

产出简洁的需求基线，给需求编号并写出可操作的验收条件。需求不能用“体验良好”“智能准确”等无法验证的措辞收尾。需要独立文档或验收表时，按需读取 [delivery-templates.md](references/delivery-templates.md)。

**完成标准**：目标、主路径、必要功能、暂缓项和验收条件足以指导实现。影响产品方向的未决问题仍须澄清；可逆的实现细节可说明假设后继续。

## 2. 设计够用且能维护的方案

优先沿用已有项目的技术、组件和接口。新项目选择满足当前需求、用户能够理解和维护的简单方案；有真实取舍时再比较备选。

解释与本次项目相关的内容：

- 主要模块分别负责什么，输入输出如何连接。
- 数据从哪里来、在哪里处理、是否需要持久化。
- 为什么选择这些技术、维护难点在哪里。
- 外部服务的接口、配置和错误如何进入系统。

有 AI 接口的 Web 应用，可用“前端收集输入 → 服务端调用模型 → 可选持久化 → 返回响应 → 前端呈现”说明链路。它是示例，不能据此强制静态页面新增服务端或数据库。区分服务端程序与后台管理页面，按真实需要建设。

只在确实处理用户数据或接入云端服务时说明数据路径和权限。密钥放在适当的运行环境配置中；不把向量化视为脱敏完成或上传数据的授权。

用用户听得懂的话说明选择与影响。遇到理解障碍时先解释，不要求用户逐个术语考试。

**完成标准**：模块边界、数据流、必要配置和主要取舍清楚，方案与项目体量及现有约束匹配。

## 3. 拆成可独立验收的小任务

围绕一条最短的可运行路径组织任务，必要时先跑通“输入到结果”的薄链路，再补充能力。避免所有页面完成后才首次接入真实接口。

每个任务至少记录：

- 要交付的具体行为及对应需求。
- 前置依赖和本任务的改动边界。
- 具体验证动作、输入和预期结果。
- 当前状态；执行后补上实际验证证据。

粒度以能独立判断成功或失败为准。一个小任务可在一次开发与验证循环内完成；“一次对话/一次提交”是粒度参考，不是硬性配额。不把功能任务拆成无法单独验收的文件修改清单。

**完成标准**：先后顺序明确，每个任务均有可观察结果，可以判断下一步是否具备条件。

## 4. 实现一项，验证一项

新项目先验证最小骨架能启动；已有项目先确认相关启动方式、依赖、当前改动和可用验证入口，不重新搭建脚手架。

对当前任务循环执行：

1. 确认预期行为和必要上下文，限制改动范围。
2. 实现当前任务及其必要配套，避免顺手加入无关功能。
3. 运行与行为和风险相称的检查；有界面交互时，验证实际操作和结果。
4. 失败则定位并修复，再复验受影响部分。尚未验证的依赖不作为后续成功前提。
5. 记录实现、验证和限制；证据足够后继续授权范围内的下一个任务。

验证应区分：代码/构建检查、模块行为、真实用户路径。构建通过不能代替界面和端到端验证。对外部接口标明使用真实服务、模拟服务还是尚未接通。

在适用时覆盖正常路径和有代表性的异常，例如空输入、请求失败、重复操作。测试依据实际风险选择，不为低影响改动机械新增测试，也不把手动验证规定成唯一方法。

AI 能操作并验证的部分先自行完成；需要用户判断主观体验、设备行为或人工验收的，给出具体操作和预期结果，并标记待用户验收，不声称用户已经亲测。只有依赖该人工结果的工作才等待。

遵从项目和用户的 Git 约定。小任务边界可作为检查点，但本 Skill 不授予 commit、push 或发布权限。

## 5. 联调、验收和交付

模块连通后，按最初定义的主路径执行一次完整操作，检查状态、接口、数据格式和结果衔接。用户可见结果依赖存储时，还应验证必要的读取或刷新行为。

逐条核对需求，分别记录：

- **实现状态**：完成 / 部分完成 / 未做；已约定暂缓的内容另行说明。
- **验证状态**：已验证 / 验证失败 / 未验证 / 待用户验收。
- 对应证据、缺口及实际影响。

不能把“代码已写”同时等同于“功能已验收”。把必须修复的问题留在当前范围内处理；其余限制明确记录。外部条件阻断时，说明具体阻点和已完成的独立工作。

交付说明包含已完成行为、运行入口、验证结果、已知限制和必要的后续动作。可接续的项目同步最相关的上下文、待办和变更记录，规则见 [project-docs.md](references/project-docs.md)。

**完成标准**：本次范围逐项有实现和验证状态；主路径有实际证据或明确阻点；下一位接手者能启动项目并识别剩余工作。

## 沟通与范围

阶段更新只讲关键发现、决定和下一步验证目标。任务完成后说明“改成什么、怎么验证、还有什么限制”，避免粘贴大量代码或机械复述表格。

本流程默认覆盖需求到开发交付，以及项目上下文维护。部署运维、推送远端、发布、对外发送和更改外部系统访问权限，应依据用户实际要求处理，不能由流程自动扩展。

## 来源

提炼自用户提供的[《第三周笔记》](https://qcn74jo8pwld.feishu.cn/wiki/BR29w857gi0zBykl9cdcE9renJe)，包括课程画板与《Coding环节提示词.md》附件；读取日期为 2026-10-16。上述阶段组织、双状态验收及适配规则为执行化整理，不是原文逐字摘录。运行本 Skill 无需再次访问原文。
