上一篇写了 GitHub Skill 的准入表。表写出来以后,最怕留在文档里,看着挺完整,真正给 Codex 下任务时又忘了筛。

这一篇我拿一个很常见的前端任务演示一遍。

场景先说明清楚。假设当前是一个已有 Vue 列表页,要在表格上方加一组批量操作区。用户勾选多行后,可以批量启用、批量停用,也可以清空选择。这里是方法演示,不宣称我已经在某个真实项目里跑出了效果。

这个任务看起来小,实际会碰到选择状态、按钮禁用、接口参数、页面刷新、移动端溢出和操作验收。很适合拿来试筛 GitHub Skill。

第一轮先把明显不合适的拿掉

我先把前几篇写过的 Skill 摆上来。

候选 Skill来源初步判断
web-artifacts-builderanthropics/skills不采用
test-driven-developmentobra/superpowers部分采用
systematic-debuggingobra/superpowers暂不采用
webapp-testinganthropics/skills采用
frontend-designvipulgupta2048/codex-skills部分采用

web-artifacts-builder 很快就出局。它适合从零搭 React、Vite、Tailwind、shadcn/ui 的独立页面。现在是已有 Vue 页面,项目骨架已经存在,再让它介入会把事情搞大。

systematic-debugging 也先不采用。当前任务是新增功能,还没有明确 bug。它可以留作后备规则,等构建失败、测试失败或页面行为异常时再切进去。

真正值得进入本次任务的,是 TDD、浏览器验证,以及设计类 Skill 里和可访问性、响应式有关的几条。

第二轮看哪些规则能变成代码动作

批量操作区里有一块逻辑很适合 TDD。选择多行以后,按钮是否可点,提交给接口的 id 列表怎么生成,清空选择以后状态怎么归零。这些都有输入和输出。

我会让 Codex 先写一个很小的测试。

请先为批量操作区的选择状态写失败测试。
​
覆盖
- 没有选择时,批量按钮不可用。
- 选择两条数据时,提交参数只包含这两条 id。
- 清空选择后,已选数量归零。

这里不要求它把整个列表页都测掉。TDD 只盯纯逻辑,页面结构交给后面的浏览器验证。

frontend-design 里能留下的规则,也要落成动作。我不会让 Codex 重新设计列表页,只保留两个检查。批量操作区在小屏下不能把按钮挤出容器,按钮和选择数量要有清晰的语义。

这两条能查。能查,才适合进入任务。

第三轮写项目冲突

这一步最容易省掉,省掉以后麻烦就来了。

项目冲突
- 不引入 React、Tailwind、shadcn/ui。
- 不改表格组件封装。
- 不改接口请求入口。
- 不重写列表查询流程。
- 不把 GitHub Skill 示例代码原样搬进 Vue 页面。

这几条是写给 Codex 的,也是写给我自己审查时看的。批量操作区只是一个小改动,它没有资格改项目结构。

外部 Skill 的规则如果和当前项目冲突,优先退回参考材料。项目已经存在的代码,比 GitHub 上通用的好建议更重要。

最后只留下 3 条规则

筛完以后,我会把任务压成三条。

本次只采用三条 GitHub Skill 规则。
​
1. 按 TDD 思路,先为选择状态和批量参数写失败测试,再写最小实现。
2. 按 frontend-design 的可访问性和响应式要求,检查按钮禁用、焦点样式、小屏溢出。
3. 按 webapp-testing 思路,交付前走一遍浏览器路径,选择、批量操作、清空选择、刷新列表都要覆盖。

三条已经够了。再多,Codex 会把任务理解成一次全面重构。

这三条还有一个好处,分别对应不同证据。第一条有测试结果,第二条有代码和页面检查,第三条有浏览器路径。交付时我可以沿着证据看,不用只听 Codex 说它照做了。

我会这样完整下任务

把前面的筛选结果合起来,交给 Codex 的任务可以写成这样。

任务
在已有 Vue 列表页上方新增批量操作区,支持批量启用、批量停用和清空选择。
​
先读当前项目中相近列表页,沿用现有表格、请求入口、状态命名和按钮样式。
​
采用的 GitHub Skill 规则只有三条。
- 先为选择状态和批量参数写失败测试,再写最小实现。
- 检查按钮禁用、焦点样式和小屏溢出。
- 交付前用浏览器走选择、批量操作、清空选择和刷新列表路径。
​
禁止
- 不引入新 UI 库。
- 不改表格组件封装。
- 不改接口请求入口。
- 不重写列表查询流程。
​
交付
- 列出采用的三条规则对应的证据。
- 列出没有采用的 GitHub Skill 和原因。
- 标明哪些页面路径需要人复核。

这份任务里没有神秘技巧。它只是把 GitHub Skill 压到当前任务能承受的范围里。

写在最后

GitHub Skill 进入前端任务,最重要的动作是筛掉。筛掉不合适的技术栈,筛掉当前阶段用不上的流程,筛掉不能验证的建议。

留下来的规则要少,要具体,要能交证据。

拿这个 Vue 列表操作区来说,最后只留三条。TDD 管选择逻辑,设计检查管可访问性和小屏,浏览器验证管用户路径。Codex 拿到的是一份能执行的前端任务,那堆外部文档留在参考区。

下一篇继续收尾。任务做完以后,GitHub Skill 里哪些规则可以留下,哪些只适合用一次,我会让 Codex 交一份规则复盘,再决定要不要写进项目长期规则。

本系列持续更新,后面继续围绕 Codex 和 GitHub Skills,把外部材料一步步压成前端开发能用的工作方式。

Logo

葡萄城是专业的软件开发技术和低代码平台提供商,聚焦软件开发技术,以“赋能开发者”为使命,致力于通过表格控件、低代码和BI等各类软件开发工具和服务,一站式满足开发者需求,帮助企业提升开发效率并创新开发模式。

更多推荐