前面全部129项任务表达按用途归入12类,配套16种常用流程。选择符合当前目标的流程,用实际验证结果判断是否完成。

使用方式

任务词属于自然语言表达,英文、中文和完整句子都能使用。把对象、范围、约束和验收条件写清楚,例如“定位动画掉帧原因,保持现有交互,用相同场景比较修改前后的帧率”。参见 OpenAI 官方提示指南。

/plan、/review 是支持它们的客户端内置入口;本表中的 fix、debug、refactor 等是普通任务表达。CLI 审查通常围绕 Git 改动,也可用自然语言指定需要审查的文件和范围。入口以当前客户端菜单为准。

默认主流程:明确目标 → 阅读相关代码并按需规划 → 实现并运行相关检查 → review → 核实问题并按需修复 → 复测与必要复查 → 实际验收 → 交付。小改动可省略单独规划,测试层级按任务选择。参见 OpenAI 官方最佳实践。

分类总览

类别项数主要用途
理解与规划12明确问题与方案
生成与实现14搭建和实现功能
调试与修复12复现、定位、修复故障
审查与验证8发现问题并核对结果
测试与检查17形成可重复的验证
重构与整理12改善结构和可维护性
性能与效率12测量并优化资源开销
界面与交互10改善视觉、适配与操作体验
安全与权限8验证和修复指定安全问题
数据处理6解析、转换、校验与聚合
运行与交付12运行、构建、发布与恢复
文档与总结6记录用法、结果与变化

合计129项,每项在主词表中只归入一个类别。

完整任务词表

理解与规划

12项。

任务词作用
clarify澄清需求与歧义
analyze分析问题与原因
inspect检查代码结构和依赖
explore浏览并熟悉项目
explain解释代码和原理
trace追踪调用链和数据流
compare对比版本或方案
research查找资料、调查方案
plan制定实施计划
design设计架构或交互方案
specify明确行为和验收条件
decompose将任务拆成小步骤

生成与实现

14项。

任务词作用
scaffold搭建项目或功能骨架
prototype制作可操作的原型
generate生成指定代码或内容
implement实现功能或方案
extend扩展现有功能
integrate整合模块或外部服务
configure配置项目或工具
adapt适配现有实现
convert转换格式或实现方式
port移植到其他语言或平台
migrate迁移接口或技术方案
upgrade升级依赖或版本
mock模拟接口或数据
stub提供简化的替代实现

调试与修复

12项。

任务词作用
reproduce复现问题和触发条件
debug调试并定位原因
diagnose诊断故障
investigate调查异常及其证据
isolate隔离问题来源
bisect定位引入问题的 Git 提交
instrument添加日志、计时或监测
minimize repro缩小为最小复现案例
fix修复确认存在的问题
patch制作针对性补丁
repair修复损坏或不一致的实现
troubleshoot排查环境、配置和运行故障

审查与验证

8项。

任务词作用
review审查改动中的问题
audit按指定范围进行专项审计
verify用运行结果验证需求是否满足
validate检查数据、输入或实现是否符合明确规则
check执行指定检查
security review审查安全风险
compatibility check检查兼容性
acceptance check按验收标准检查

测试与检查

17项。

任务词作用
test编写或运行相关测试
unit test测试单个函数或单元
integration test测试模块间协作
e2e test测试完整用户流程
smoke test快速检查主要功能
regression test检查旧问题是否再次出现
snapshot test检查输出快照变化
visual regression test检查意外的页面视觉变化
accessibility test测试键盘、语义和其他无障碍访问行为
load test测试设定负载下的表现
stress test测试极限负载表现
fuzz test用大量变异输入寻找异常
retest修复后重新运行相关测试
lint运行代码静态检查规则
typecheck检查类型错误
test coverage检查关键路径与边界是否有测试覆盖
build check检查项目能否构建

重构与整理

12项。

任务词作用
refactor调整代码结构,保持约定的外部行为
simplify简化复杂逻辑
extract抽取公共函数或组件
inline将函数或变量展开到使用处
rename重命名并更新相关引用
split拆分文件、函数或组件
modularize按职责组织成模块
decouple减少模块之间的依赖
deduplicate合并重复实现
consolidate统一分散的同类实现
cleanup清理确认无用的代码
format统一代码格式

性能与效率

12项。

任务词作用
profile测量并定位性能瓶颈
measure测量耗时、帧率或资源占用
optimize优化性能或资源开销
benchmark在可比较条件下测量性能并进行对比
cache缓存可复用结果
memoize复用相同输入对应的函数计算结果
batch将多次操作合并处理
parallelize将独立工作并行执行
lazy-load按需加载代码或资源
debounce防抖,减少连续事件触发的实际处理次数
throttle节流,限制一段时间内的处理频率
reduce bundle size减少前端构建产物体积

界面与交互

10项。

任务词作用
polish打磨视觉和交互细节
responsive适配不同屏幕尺寸
accessibility改善键盘操作、语义和无障碍体验
style调整视觉样式
align修正对齐和间距
animate添加或调整动画
synchronize同步动画、状态或控制变化
match screenshot按参考截图调整界面
preview启动预览并实际查看效果
playtest实际试玩并检查体验

安全与权限

8项。

任务词作用
harden针对确认的风险加强安全防护
sanitize按使用场景清理或限制不可信输入
escape针对输出上下文正确转义特殊字符
redact隐藏或脱敏敏感信息
authenticate实现或检查身份认证
authorize实现或检查权限控制
dependency audit检查依赖的已知风险
secret scan检查代码中的密钥等敏感信息泄露

数据处理

6项。

任务词作用
parse解析输入数据
serialize将对象编码为可存储或传输格式
deserialize将编码数据还原为对象
normalize统一数据格式和取值约定
transform转换数据结构或内容
aggregate汇总或聚合数据

运行与交付

12项。

任务词作用
run运行项目或命令
build构建项目
compile编译源代码
bundle打包代码及其依赖
package生成可分发的软件包
deploy部署到指定环境
release准备或发布指定版本
rollback回滚部署或版本
monitor监测运行状态
commit创建 Git 提交
resolve conflicts解决合并冲突
revert撤销指定改动

文档与总结

6项。

任务词作用
document补充技术或使用文档
comment添加必要的代码注释
summarize总结改动、验证结果和限制
changelog整理版本变更记录
write README编写项目使用说明
write examples编写可运行的使用示例

常用流程总览

箭头表示默认顺序。修复以核实问题为前提,测试层级按任务选择,发布步骤只在任务包含相应交付范围时执行。

编号场景适用情况
1接手项目和理解代码刚接触仓库,需要弄清入口、模块和运行方式。
2开发新功能把已有方向的需求实现并交付。
3制作快速原型先验证想法、布局或核心交互。
4定位并修复 bug出现报错、错误结果或不稳定行为。
5代码审查后的核实与修复代码刚写完,或已拿到 review 结果。
6补齐测试与检查关键路径、边界或模块协作缺少检查。
7重构和整理代码重复实现、职责混杂或依赖关系影响维护。
8优化性能加载慢、运行慢、内存高或卡顿。
9打磨页面和响应式体验修正布局、视觉细节、屏幕适配或无障碍体验。
10修正动画和交互同步动作不同步、暂停恢复异常、缩放漂移或控制失效。
11接入接口和外部服务接入 API、整合前后端或对接服务。
12升级依赖和迁移实现升级依赖、替换接口或迁移技术方案。
13安全检查和针对性修复检查认证、权限、输入、依赖或敏感信息泄露。
14数据解析与转换处理文件、规范数据或转换结构。
15构建发布和运行验证完成开发后准备版本或部署。
16补充文档和交付说明更新 README、示例、注释或版本说明。

常用流程执行细则

01 接手项目和理解代码

适用场景:刚接触仓库,需要弄清入口、模块和运行方式。

顺序:inspect → trace → explain → document。

围绕一个入口或用户流程阅读,形成可核对的代码地图。

完成条件:能指出关键文件、调用关系和运行测试命令,疑问有记录。

可直接输入:

阅读项目,说明入口、核心模块、数据流、运行方式和测试命令。给出对应文件位置,列出尚不明确的地方。

02 开发新功能

适用场景:把已有方向的需求实现并交付。

顺序:clarify → /plan → implement → test → /review → verify。

小改动可省略单独规划。审查发现问题时使用审查修复流程,确认解决后再验收。

完成条件:约定的正常路径、关键边界和交互满足需求,相关检查实际通过。

可直接输入:

实现这个功能:先读相关代码并明确验收标准;复杂部分先规划,分步实现并运行相关测试。完成后审查、核实并修复问题,最后按真实使用流程验收。

03 制作快速原型

适用场景:先验证想法、布局或核心交互。

顺序:clarify → scaffold → prototype → preview → verify。

先明确原型要回答的问题,围绕主要流程做可操作版本。

完成条件:约定的核心交互可演示,原型范围和后续方向清楚。

可直接输入:

先做能操作的原型,覆盖最重要的用户流程。启动预览并检查核心交互,说明哪些已完成、哪些属于下一阶段。

04 定位并修复 bug

适用场景:出现报错、错误结果或不稳定行为。

顺序:reproduce → debug → regression test → fix → retest → /review → verify。

有意义且可执行的回归测试应在修复前暴露问题、修复后通过。先保留失败证据,再针对性修改。

完成条件:原复现步骤不再触发问题,相关正常行为通过检查。

可直接输入:

先复现问题并定位原因,保留失败证据。适合自动测试时先补能暴露问题的回归测试,再修复、复测并审查改动,验证原问题及相关正常流程。

05 代码审查后的核实与修复

适用场景:代码刚写完,或已拿到 review 结果。

顺序:/review → verify → fix → retest → /review。

fix 只处理确认存在的问题;没有代码变化和新证据时,不机械重复审查。

完成条件:接受处理的问题已核实和解决,必要复查完成,未执行的检查有记录。

可直接输入:

审查本次改动,按影响列出问题及证据。逐项核实,修复确实存在的问题,运行相关测试;对实际修复的内容再次审查,说明验证结果。

06 补齐测试与检查

适用场景:关键路径、边界或模块协作缺少检查。

顺序:test coverage → mock → test → /review。

按需求选择 unit test、integration test、e2e test 等层级;mock 只在需要隔离外部依赖时使用。

完成条件:关键场景有可解释的断言,测试实际运行,失败能反映有意义的问题。

可直接输入:

检查关键路径和测试缺口,选择合适的测试层级,补充必要的正常、异常和边界用例。运行相关测试,说明每组测试验证什么。

07 重构和整理代码

适用场景:重复实现、职责混杂或依赖关系影响维护。

顺序:inspect → test → refactor → test → /review → verify。

先运行现有相关检查作为基线;extract、split、modularize、decouple 按问题选择。

完成条件:约定的外部行为和接口一致,相关测试通过,结构符合重构目标。

可直接输入:

先理解代码并运行相关现有检查。按目标重构,保持约定的接口和外部行为;改完重跑检查,再审查是否引入回归。

08 优化性能

适用场景:加载慢、运行慢、内存高或卡顿。

顺序:measure → profile → optimize → benchmark → test → /review。

先记录基线并定位主要瓶颈;比较前后数据,说明测量限制。

完成条件:相同输入和可比较环境下达到约定指标,正确性检查通过。

可直接输入:

先记录性能基线并定位瓶颈,再针对性优化。用相同输入和可比较环境测量修改前后结果,运行正确性检查,报告收益和限制。

09 打磨页面和响应式体验

适用场景:修正布局、视觉细节、屏幕适配或无障碍体验。

顺序:inspect → polish → responsive → accessibility → preview → visual regression test → verify。

实际检查桌面和移动尺寸。已有视觉基线时做截图对比;没有基线时按参考图和验收项检查。无法运行的项目列出。

完成条件:目标尺寸下布局交互符合要求,关键状态可用,视觉变化有依据。

可直接输入:

打磨页面间距、对齐、遮挡、移动适配和交互反馈。启动预览,检查点击、键盘焦点、错误及空状态;已有视觉基线时截图对比,记录结果。

10 修正动画和交互同步

适用场景:动作不同步、暂停恢复异常、缩放漂移或控制失效。

顺序:reproduce → trace → synchronize → preview → playtest → verify → /review。

核对时间源、父子变换和控制状态;出现掉帧时再使用性能优化流程。

完成条件:动作与状态符合约定,暂停、恢复、重置和控制操作稳定,复现步骤通过。

可直接输入:

定位动画不同步、缩放漂移和控制失效的问题。核对时间源、父子变换和状态更新,修复后实际操作暂停、恢复、重置、拖动和缩放,按复现步骤验收。

11 接入接口和外部服务

适用场景:接入 API、整合前后端或对接服务。

顺序:specify → mock → integrate → integration test → security review → verify。

先明确请求响应契约,再按业务需要检查超时、错误、空数据和重试。

完成条件:接口契约与关键异常路径通过验证,认证权限符合要求。

可直接输入:

按接口契约接入,核对请求、响应和错误处理。验证正常、空数据、错误、超时及权限不足场景;涉及重试时检查重复提交,运行相关集成测试。

12 升级依赖和迁移实现

适用场景:升级依赖、替换接口或迁移技术方案。

顺序:inspect → plan → migrate → typecheck → test → /review → verify。

依赖升级可使用 upgrade;记录原版本、锁文件及受影响调用,逐步验证。

完成条件:目标版本和关键行为得到验证,相关构建测试通过,兼容变化和恢复方式清楚。

可直接输入:

核对当前版本、依赖和受影响调用,制定步骤并逐步升级或迁移。运行相关构建、类型及测试检查,审查兼容变化,记录恢复原状态所需信息。

13 安全检查和针对性修复

适用场景:检查认证、权限、输入、依赖或敏感信息泄露。

顺序:audit → verify → harden → regression test → /review → verify。

按问题选择 sanitize、escape、authenticate、authorize、redact 等动作;结论限定在实际审查范围。

完成条件:接受处理的风险有证据和验证,合法使用路径可用,覆盖范围与限制清楚。

可直接输入:

按指定范围检查安全问题,给出触发条件、代码位置和证据。核实后针对性修复,验证原问题与合法使用路径,说明覆盖范围和未完成的验证。

14 数据解析与转换

适用场景:处理文件、规范数据或转换结构。

顺序:specify → parse → normalize → transform → validate → test → verify。

先用保留样本及预期输出验证;按需加入 aggregate,检查缺失、重复、空值和类型。

完成条件:样本预期输出一致,关键规则通过,数量和异常记录可核对。

可直接输入:

明确输入、输出及规则,用保留样本验证解析、规范化和转换。检查缺失、重复、空值、类型和数量,核对预期输出,再按同样规则处理完整输入。

15 构建发布和运行验证

适用场景:完成开发后准备版本或部署。

顺序:test → build → /review → document → changelog → package → deploy → smoke test → monitor → verify。

部署以明确的环境、版本和发布权限为前提。保留确定的恢复版本,验证失败时按约定条件处理 rollback。

完成条件:构建与相关检查通过,目标环境关键路径及健康状态符合要求,交付信息可追溯。

可直接输入:

准备指定版本的交付:运行相关测试与构建,审查改动,更新文档和变更记录并打包。任务包含发布且环境、版本和权限明确时部署,随后检查主要流程与运行状态,记录结果和恢复版本。

16 补充文档和交付说明

适用场景:更新 README、示例、注释或版本说明。

顺序:inspect → document → write examples → verify → changelog → summarize。

按任务选择 write README、comment 或 changelog;环境允许时执行示例并检查链接。

完成条件:说明与当前实现一致,关键命令和示例已核验,未验证内容和范围清楚。

可直接输入:

以当前代码及已验证行为更新文档、README 和示例。核对运行命令、配置、链接和示例,实际执行能运行的部分,总结改动、验证结果和剩余限制。

复测与结束条件

  1. 明确结果。写清功能行为、关键边界、运行环境和验收方法。

  2. 用证据核实 review 发现,再决定是否修复;每次修改后运行相关检查。

  3. 修复完成后,重跑原复现步骤或对应测试,并按修改范围复查。

  4. 页面和动画包含实际预览操作,性能优化包含可比较的测量数据。

  5. 需求满足、相关检查通过、接受处理的重要问题解决后结束。检查无法运行时,记录具体原因与影响。

  6. 达到约定时间或预算、继续尝试不再带来新证据,或遇到无法自行解决的阻塞时,说明已完成内容、证据和下一步所需信息。

停止条件参照 OpenAI 的迭代修复工作流。词条释义、12类划分及16条流程是为日常使用整理的组合,具体步骤按项目需要选用。

容易混淆的任务表达

表达区别
review、verify、validatereview 寻找改动中的问题;verify 用证据核对需求结果;validate 检查明确的数据规则或约束。
fix、refactorfix 改正错误行为;refactor 改善结构并保持约定的外部行为。
profile、benchmarkprofile 定位性能时间或资源花在哪里;benchmark 在可比较条件下测量和对比效果。
mock、stubmock 模拟交互或行为,也可用于验证调用;stub 提供简化的替代响应或实现,实际用法按测试工具约定。
lint、typecheck、format分别用于代码静态规则检查、类型检查、格式统一;对应工具由项目决定。
rollback、revertrollback 恢复部署或版本状态;Git revert 用新的提交撤销指定提交的改动,普通任务词 revert 也可泛指撤销。
release、deployrelease 准备或发布版本;deploy 将指定版本部署到目标环境。

官方参考