从需求到交付成功的项目级闭环技能。覆盖"理解需求→拆解任务→开发实施→验证质量→交付上线→复盘沉淀"六阶段,融合目标锚定、风险预演、质量门禁、用户验收四道闸门。适用于任何软件开发、产品落地、个人项目的端到端推进,让你不再在"做完一部分"和"完整交付"之间反复横跳。
winson-requirement-to-delivery-loop是一项面向实际任务的技能,主要用于从需求到交付成功的项目级闭环技能;一、核心哲学(必读);
真正的交付是: 用户能完整使用、关键路径全打通、失败不丢数据;1.2 三个底层。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
从需求到交付成功的项目级闭环技能
围绕核心目标锚定优先级,把每一分算力都投在"能否让用户验收通过"这一件事上。
不是"代码写完",不是"功能跑通",不是"页面好看"——这些都只是交付的必要条件。真正的交付是:用户能完整使用、关键路径全打通、失败不丢数据。
| 认知 | 说明 |
|---|---|
| 核心目标是北极星 | 没有锚定的开发会陷入"修了 A 发现 B 也没接"的无底洞。第一步必须明确"这个项目/这次迭代要让用户能用哪些核心路径" |
| 逆向工程是反熵增的利器 | 需求方给的描述永远不完整。用"系统化扫描+逆推功能意图"补全缺失,比追问更高效 |
| 沉淀比交付更值钱 | 每完成一次交付,把踩坑、可复用模式、决策逻辑写入 MEMORY/CHANGELOG。下次遇到类似问题,3 步内定位 |
理解需求(明确核心目标 + 关键路径)
→ 拆解任务(按交互元素类别分类,而非按页面)
→ 开发实施(同一类型问题并行处理)
→ 验证质量(语法 + 引用 + 端到端)
→ 交付上线(用户视角验收清单)
→ 复盘沉淀(踩坑入坑库,模式入复用库)
→ 循环:下一个需求进来时,从 MEMORY 优先读取
| 闸门 | 检验内容 | 失败信号 |
|---|---|---|
| 目标闸门 | 这次开发是不是冲着核心目标去的? | 开始做一些"看起来有用但与核心目标无关"的功能 |
| 风险闸门 | 关键路径上的失败点有没有被预演过? | 用户在使用过程中会遇到"点击没反应""数据没保存""页面 404" |
| 质量闸门 | 语法/引用/边界条件有没有检查? | 出现 ReferenceError、undefined function、null pointer |
| 验收闸门 | 用户视角能完整跑通关键路径吗? | 交付后用户问"这个按钮怎么用" |
做什么:用一句话回答"这次要让用户能完成什么"。
为什么重要:所有后续决策都要回溯到这一句话。任何偏离核心目标的工作都是浪费算力。
检验标准:
反例:
做什么:用 5W1H 主动补充需求方没说的内容。
| 维度 | 要回答 |
|---|---|
| Who | 谁会使用?角色是什么?(医生/患者/管理员) |
| What | 关键功能是否完整?是否有"必然存在但没说"的功能?(搜索/筛选/排序/分页/导入/导出) |
| When | 是否有时间约束?是否需要倒计时/截止日期/历史记录? |
| Where | 数据存在哪?localStorage / 接口 / 文件? |
| Why | 用户为什么用这个?解决什么痛点? |
| How | 失败时如何处理?空数据如何展示? |
检验标准:能列出至少 5 条需求方没明说但必须实现的功能。
做什么:和需求方对齐"什么是做完",避免无限循环。
模板:
本次迭代完成 = ✅ 关键路径 1: [用户路径 + 完成标志] ✅ 关键路径 2: [...] ✅ 关键路径 3: [...] ✅ 数据持久化: [数据存哪、怎么读出来] ✅ 异常处理: [失败时用户看到什么] ⏸️ 不在本次范围: [明确说"不做"的事项]
反例(按页面拆):
P1: 仪表盘页面 P2: 客户列表页面 P3: 客户详情页面 P4: 计划页面 ...
问题:按页面拆会让你陷入"做完仪表盘去做客户"的串行模式。但其实"按钮没接事件"这种问题在每个页面都存在,应该一次性扫完。
正例(按交互类别拆):
P1: 全局导航(侧边栏 + 顶部栏 + Logo + 头像 + 主题切换 + 锁屏) P2: 数据列表(客户/计划/模板/知识库 × 搜索 + 筛选 + 分页 + 行点击) P3: 详情页(标签页 + 内嵌统计 + 关联跳转 + 编辑/删除按钮) P4: 模态弹窗(新增/编辑/确认/详情查看) P5: 装饰性交互(标签点击筛选、性别条筛选、趋势图、徽章) P6: 数据持久化 + 异常处理 P7: 验收清单(用户视角的端到端测试)
优势:同类问题一次性扫完,并行处理,效率高 3-5 倍。
做什么:识别"必须先做"和"可以并行做"的任务。
模板:
[必须先做] - 数据模型定义(影响所有页面) - 路由/页面切换(影响所有跳转) [可以并行做] - 各页面的渲染函数 - 各模态的打开/保存函数 - 各种工具函数(脱敏、格式化、ID生成)
模板:
任务:[描述] 完成标志: - 函数/文件存在 - 在 X 场景下点击会触发 Y - Y 完成时会更新 Z 状态 - Z 状态会持久化到 W 存储
反例:
顺序:
为什么:骨架不通,所有细节都是空中楼阁。先跑通"只读"路径,再加"写"。
验证清单:
node --check 或 IDE 红色波浪线)反模式:
为什么:bug 会传染。一个未修的 bug 会让后续代码基于错误假设,导致更多 bug。
模板:
发现 bug
→ 立即定位(不要"先标记,稍后看")
→ 立即修复(不要"等修大功能时一起改")
→ 立即验证(修完就跑一遍相关路径)
→ 立即记录(写入 MEMORY 的踩坑区)
适用场景:关键交互元素(导航、提交、删除、锁屏)
做法:同时用 addEventListener + onclick 直接绑定
// bindFilters 内部
const btn = $('#themeToggle');
if(btn) btn.addEventListener('click', toggleTheme);
为什么:DOMContentLoaded 之前的事件不会触发,addEventListener 失败的话 onclick 兜底。
HTML 单文件项目:
# 提取 script 标签内容并检查语法
node -e "const fs=require('fs');const html=fs.readFileSync('index.html','utf8');const m=html.match(//);if(m){try{new Function(m[1]);console.log('OK');}catch(e){console.log('ERROR:',e.message);}}"
多文件项目:
# 后端 node --check server.js # 前端构建 npm run build # 类型检查 tsc --noEmit
做什么:扫描所有 onclick / addEventListener / 模板字符串中引用的函数,确保它们都存在。
方法 1:人工扫描(小项目)
# 提取所有 onclick 中的函数名
grep -oE 'onclick="[a-zA-Z_]+(' file.html
# 提取所有函数定义
grep -oE 'function [a-zA-Z_]+' file.html
# 对比是否一致
方法 2:静态分析(大项目)
no-undef 规则反模式:
openClientModal(btn.dataset.id) 用了 btn 但实际变量名是 act(ReferenceError)用户视角验收清单(按关键路径):
| 路径 | 操作序列 | 预期结果 |
|---|---|---|
| 录入客户 | 点"新增客户" → 填表 → 保存 | 列表多一条、刷新不丢、可编辑可删除 |
| 查看详情 | 点客户行 → 看详情 | 显示该客户的所有数据 |
| 建计划 | 进详情 → 点"+ 计划" → 选客户 → 填表 → 保存 | 计划列表多一条、关联到客户 |
| 切换主题 | 点主题按钮 | 全站颜色变化、刷新保持 |
| 数据导出 | 点"导出" | 下载 JSON 文件、文件可读 |
反模式:
必查清单:
给用户:
给自己:
✅ 已完成 [核心目标]: 1. [关键功能 1] - 测试方式:XXX 2. [关键功能 2] - 测试方式:XXX 3. [关键功能 3] - 测试方式:XXX 📋 数据已持久化到 [位置],刷新不丢。 ⚠️ 已知限制:[如"目前不支持导入历史数据"] 🔄 下次可继续:[如"可加用户权限管理"]
1. 踩坑入坑库
## 踩坑记录 - **编辑按钮 ReferenceError** → 事件委托中用 `btn` 变量但实际是 `act` → 改用解构后的 `id/idx` - **性别筛选无效** → 传 'male' 但 select value 是 '男' → 加值映射
2. 模式入复用库
## 可复用模式 ### 双保险事件绑定 - 关键交互元素同时用 addEventListener + onclick - 适用:导航、提交、删除、锁屏 ### 编辑模式 XXX_EDIT_IDX - -1 = 新增, >=0 = 编辑 - 适用:同一模态支持增改
3. 决策入决策库
## 决策记录 - **为什么用 localStorage 不用后端** → 单文件项目、无需多端同步 - **为什么用 onclick + addEventListener 双保险** → addEventListener 在某些边界场景不触发
什么值得沉淀为技能:
什么不值得:
下次接到类似需求时:
| 陷阱 | 表现 | 后果 | 修正 |
|---|---|---|---|
| 目标漂移陷阱 | 做着做着去优化一些"看起来有用"的功能 | 算力分散,核心目标没完成 | 每 30 分钟回溯核心目标,偏离就停下 |
| 页面陷阱 | 按页面顺序开发,做完 A 再做 B | 同一类问题在不同页面反复出现 | 按交互类别扫,一次性处理同类 |
| 语法自信陷阱 | 写完不检查语法,运行时才发现 | 整个应用崩在第一行 | 写完每个函数就 node --check |
| 引用自信陷阱 | 复制粘贴时不改变量名 | ReferenceError | 引用完整性扫描(Phase 4 Step 2) |
| 完成错觉陷阱 | "代码写完"="功能完成" | 用户用不起来 | 端到端验收(Phase 4 Step 3) |
| 知识流失陷阱 | 做完不写 MEMORY | 下次踩同样的坑 | 强制把沉淀作为交付的一部分 |
| 无限循环陷阱 | "再做一点就更好" | 永远交付不了 | Phase 1 Step 3 定义"完成"边界 |
| 确认瘫痪陷阱 | 每步都问用户 | 用户没耐心 | 零确认执行,最后统一验收 |
| 场景 | 重点强调的 Phase | 关键调整 |
|---|---|---|
| 从 0 到 1 的新项目 | Phase 1 + Phase 2 | 多花时间在核心目标定义和任务分类 |
| 已有项目补全功能 | Phase 2 + Phase 3 | 先扫"哪些交互元素没接",按类别批量修 |
| 紧急 bug 修复 | Phase 3 Step 3 + Phase 4 | 立即定位→立即修→立即验→立即记 |
| 多人协作项目 | Phase 2 + Phase 5 | 任务依赖图清晰,交付物有明确边界 |
| 个人/副业项目 | 全部六阶段,简化 | 一个人 = 同时是产品/开发/QA,靠 SKILL 自我约束 |
| AI 协作项目(当前主流) | 全部六阶段 | MEMORY 是 AI 的工作记忆,必须持续更新 |
完成一次交付前,逐项检查:
node --check 语法通过?| 维度 | winson-requirement-to-delivery-loop | self-evolving-loop |
|---|---|---|
| 视角 | 项目级(单次交付) | AI 级(持续协作) |
| 时间盒 | 有明确起点和终点 | 无限循环 |
| 输出 | 可交付的产品 | 持续改进的产品 + 不断丰富的 MEMORY |
| 适用 | 接到需求→做出能用的东西 | 长期陪伴一个项目的所有迭代 |
| 关系 | self-evolving-loop 的"单次循环" | winson-requirement-to-delivery-loop 的"持续化" |
何时用哪个:
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习