任务路线

协作交付

改动能被别人看懂、审过、合并:版本、评审与验收。

版本协作

8 个条目

GitGit

协作交付

改完代码我保存了,为什么队友还看不到?我的改动到底被 Git 放在哪了?

Source Control1 处未提交
工作区

src/theme.tsM · 未进暂存

暂存区

空 · 下次提交还没有候选

历史

9f2a1c登录失败显示错误提示

结论:编辑器保存只写工作区。要进历史,得先 add 再 commit,才会多出一枚带 SHA 的快照。

提交Commit

协作交付

senior 让我把这一坨改动拆开,每个 commit 只干一件事——为什么不能一把梭?

9d2e8a4parent 8d1a2c0可独立 revert
修复登录失败后清空密码
  • src/auth/login.ts
  • tests/auth/login.spec.ts
  • docs/auth/login.md

3 文件 · 同一意图

结论:提交是带 hash/parent 的快照,不是 diff 袋子。只有一个意图,才能独立 revert。

分支Branch

协作交付

「同事说 main 受保护、要我开 feature 分支再动手——分支到底是个什么东西?切过去文件怎么就变了?」

Branch指针,不是副本
c1
HEAD→mainc2
devc3

对照:main 与 dev 只是贴在不同提交上的名字git switch dev 把 HEAD 挪到 c3,不复制文件——工作区被换成 c3 那份快照。

拉取请求Pull Request

协作交付

PR 只写了一句「改完了」,看不到 CI 状态,也不知道谁能批准、什么时候能合。

Pull requestOpen
#184 登录失败时清空密码

feature/login-errormain

  • Checks · 运行中
  • Reviewers · 0
Merge 禁用

结论:PR 是一道门,不是直接 push。CI 没绿、没人批准,Merge 就按不下去。

代码评审Code Review

协作交付

每处 diff 都还没给结论,拦截也没修复,就点了批准合并。

server/projects.ts · L42拦截
+ const sql = `SELECT * WHERE owner='${uid}'`;

必须改未登录就能把 uid 拼进 SQL。参数化 + req.user.id。

结论:评审意见钉在这一行上。拦截没修,就不能批准合并。

差异Diff

协作交付

PR 里红红绿绿一大片,我到底该看哪几行?diff 能告诉我改对了吗?

src/auth/login.ts@@ -10,3 +10,4 @@
  const result = api.login(email, password);+  result.catch(() => clearPassword());  return result;

结论:+ / − 标出哪几行变了。「为什么变、变得对不对」要另查测试和评审。

冲突Conflict

协作交付

Git 说有冲突,文件里冒出 <<<<<<< ======= >>>>>>>,我随便点一下保留一边行不行?

src/auth/login.tsboth modified
<<<<<<< HEADif (failed) { retry(); }=======if (failed) { clearPassword(); }>>>>>>> feature

结论:标记还在文件里。Git 不替你猜,删干净并留下双方意图才能继续合并。

合并Merge

协作交付

把功能分支合进 main,有时只是指针动一下,有时却多出一个提交,差别在哪?

git log --graph两个父节点

e5f29a4Merge feature/login-error into mainparents:d4c81a5 · b7c2091

结论:两边都动过,就新建一枚带两个父节点的提交,把分叉接回一条线。

工程协作

3 个条目
协作交付

仓库里那份 README,到底要写到什么程度,别人才不会卡住?

README.md能照做
周末花束

花店预览页。本地启动:

npm run dev

结论:新人打开文档就能照命令跑起来,缺命令就卡死。

协作交付

还没点运行,编辑器里那条红线是怎么来的?它和测试有什么不同?

app.tsx · 第 12 行error
if (user == null)

用 === 代替 == · 不运行也能扫出来

结论:静态按规则扫代码,红线标行号,error 能挡住合并。

测试Test

协作交付

改了一行价格格式,怎么知道以前对的东西没被改坏?

formatPrice(1299)通过
期望 ¥1,299

实际也是 ¥1,299 · 红灯才能拦住回归

结论:先写期望,再跑实现;对不上就红灯,挡住改坏的合并。

设计交付

2 个条目

设计交付Design Handoff

协作交付

“设计稿给了,开发做出来总走样、还老让我确认细节——该交什么才不用反复扯皮?”

只给截图
  • 规格
  • token 硬编码
  • 状态
  • 异常
✗ 打回 · 缺 5 项
完整交付
  • 规格
  • token
  • 状态
  • 异常
✓ 一次过

结论:交付含规格/token/状态/边界,开发可逐项验收、一次过;只给截图,缺项只能靠猜、被打回。

FigmaFigma

协作交付

“设计师都在 Figma 里改图,发我一个链接——这链接到底能看到什么,我和开发怎么对得上?”

  • 设计稿外观构图
  • Dev ModeCSS 规格
  • 组件库主组件+实例
  • 变量主题值

结论:同一份文件,4 个视角各取所需;改一处主组件或变量,所有实例同步——这就是 Figma 这类协作式设计工具的单一事实来源。

产品方法

4 个条目

验收标准Acceptance Criteria

让 AI 听话协作交付

需求只写「差不多能用」,没有成功/失败条件和复现步骤,团队无法统一判断是否完成。

故事票 · 收藏与保存未登录收藏会去登录,保存失败仍可重试
  • 390px 无横向滚动通过
  • 保存 500 仍可重试失败
  • 未登录收藏跳登录待验证

不可交付 · 先复现失败那条

结论:有一条失败就不能交付;失败要复现、修复、再验收。

优先级Priority

协作交付

“这些任务都说很重要,没有影响 / 紧急标准,也没有公开的推迟项。”

本周迭代看板
P0登录失败可重试
P1分享卡缺缩略图
P2次要横向滚动
P3分析报表 · 推迟

结论:先做 P0 登录;P3 分析公开推迟,下周复查。

用户流程User Flow

协作交付

“流程只画发现到分享的成功箭头,表单错误和登录过期后用户无处可去。”

产品路径 · 注册到分享
  1. 发现首页入口
  2. 注册验证邮箱
  3. 创建项目名缺了
  4. 分享公开链接

↩ 回到创建 · 草稿还在

结论:失败要回原步骤并保留输入,不能踢回首页。

原型Prototype

协作交付

“原型只贴了三张截图,点不动也看不出创建结果,评审变成看图说话。”

欢迎开始创建
创建我的作品集
完成我的作品集已创建

▣ 占位数据 · 未连后端

结论:路径可点通 → 结果可观察 → 评审看流程,不纠结像素。

做完这一步之后

知识点可以反复查;任务则建议按「搭页面 → 交互 → 数据 → AI → 上线 → 协作」推进。