拿 Vue 列表操作区试筛 Skill,我只让 Codex 留下 3 条规则
上一篇写了 GitHub Skill 的准入表。表写出来以后,最怕留在文档里,看着挺完整,真正给 Codex 下任务时又忘了筛。
这一篇我拿一个很常见的前端任务演示一遍。
场景先说明清楚。假设当前是一个已有 Vue 列表页,要在表格上方加一组批量操作区。用户勾选多行后,可以批量启用、批量停用,也可以清空选择。这里是方法演示,不宣称我已经在某个真实项目里跑出了效果。
这个任务看起来小,实际会碰到选择状态、按钮禁用、接口参数、页面刷新、移动端溢出和操作验收。很适合拿来试筛 GitHub Skill。
第一轮先把明显不合适的拿掉
我先把前几篇写过的 Skill 摆上来。
| 候选 Skill | 来源 | 初步判断 |
|---|---|---|
web-artifacts-builder | anthropics/skills | 不采用 |
test-driven-development | obra/superpowers | 部分采用 |
systematic-debugging | obra/superpowers | 暂不采用 |
webapp-testing | anthropics/skills | 采用 |
frontend-design | vipulgupta2048/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,把外部材料一步步压成前端开发能用的工作方式。
葡萄城是专业的软件开发技术和低代码平台提供商,聚焦软件开发技术,以“赋能开发者”为使命,致力于通过表格控件、低代码和BI等各类软件开发工具和服务,一站式满足开发者需求,帮助企业提升开发效率并创新开发模式。
更多推荐



所有评论(0)