前面全部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 和示例。核对运行命令、配置、链接和示例,实际执行能运行的部分,总结改动、验证结果和剩余限制。
复测与结束条件
-
明确结果。写清功能行为、关键边界、运行环境和验收方法。
-
用证据核实 review 发现,再决定是否修复;每次修改后运行相关检查。
-
修复完成后,重跑原复现步骤或对应测试,并按修改范围复查。
-
页面和动画包含实际预览操作,性能优化包含可比较的测量数据。
-
需求满足、相关检查通过、接受处理的重要问题解决后结束。检查无法运行时,记录具体原因与影响。
-
达到约定时间或预算、继续尝试不再带来新证据,或遇到无法自行解决的阻塞时,说明已完成内容、证据和下一步所需信息。
停止条件参照 OpenAI 的迭代修复工作流。词条释义、12类划分及16条流程是为日常使用整理的组合,具体步骤按项目需要选用。
容易混淆的任务表达
| 表达 | 区别 |
|---|---|
review、verify、validate | review 寻找改动中的问题;verify 用证据核对需求结果;validate 检查明确的数据规则或约束。 |
fix、refactor | fix 改正错误行为;refactor 改善结构并保持约定的外部行为。 |
profile、benchmark | profile 定位性能时间或资源花在哪里;benchmark 在可比较条件下测量和对比效果。 |
mock、stub | mock 模拟交互或行为,也可用于验证调用;stub 提供简化的替代响应或实现,实际用法按测试工具约定。 |
lint、typecheck、format | 分别用于代码静态规则检查、类型检查、格式统一;对应工具由项目决定。 |
rollback、revert | rollback 恢复部署或版本状态;Git revert 用新的提交撤销指定提交的改动,普通任务词 revert 也可泛指撤销。 |
release、deploy | release 准备或发布版本;deploy 将指定版本部署到目标环境。 |