$ codex
> 用 dev-auto 看登录页下一步
当前 需求边界未确认
建议 dev-grill-docs
之后 dev-tdd -> dev-verify
返工通常从这六个地方开始。
先查清是哪一处出了问题,再决定用哪个 skill。
- 需求没写清需求里没有边界和验收条件,代码已经改了一半。
- 结果没有命令可复查回复里只写“已完成”,没有测试命令、输出或失败项。
- 只消掉报错异常不再出现,但数据路径和 root cause 仍没查清。
- UI 只对上截图input、tab、select 和 button 还没有真实状态与交互。
- 接口列表缺类型只摘 endpoint,schema、DTO 和复用 type 没跟上。
- diff 混进别的改动commit 前才发现临时文件、无关格式化或未验证代码。
通常怎么做:先把需求说清,再写代码。
复杂改动先补 plan。实现或修复完成后,运行验证命令,再看 diff 是否能提交。
-
需求
dev-grill-docs
dev-design-context确认术语、边界和验收条件;做 UI 时先补设计上下文。
-
方案
dev-plan改动复杂或风险高时,再写文件范围、取舍和验证命令。
-
实现 / 修复
dev-tdd
dev-fix新功能先写失败测试;bug 先复现,再追 root cause。
-
验证
dev-verify运行本次改动需要的命令,原样记录通过项和失败项。
-
Review / 收尾
dev-code-review
dev-finish看完整 diff,确认没有夹带,再决定 commit、PR 或合并。
拿不准下一步时,用 dev-auto 判断当前阶段。其他 skill 仍由你明确调用。
卡在哪一步,就用哪一个 skill。
下面按工作状态分成五组,先找当前问题。
- 不知道下一步
dev-auto- 根据当前任务和已有产物,给出下一步 skill。
- 需求与方案
dev-design-context,dev-grill-docs,dev-spec,dev-plan- UI 先补设计上下文;模糊需求先写 spec,复杂改动再补 plan。
- API 契约
swagger-doc-skill- 从在线文档读取 module、endpoint、请求响应和可复用 type/schema。
- 实现与修复
dev-image-to-code,dev-tdd,dev-fix- 按截图还原 UI,用失败测试锁新功能,或沿数据路径修 bug。
- 验证与提交
dev-verify,dev-code-review,dev-commit-writer,dev-finish- 运行验证、检查 diff、写 commit message,并处理 PR 或分支收尾。
user
> Source: https://petstore3.swagger.io/api/v3/openapi.json
> 查这个 Petstore 文档,列出全部 endpoint 和可复用 type/schema。
assistant
Source https://petstore3.swagger.io/api/v3/openapi.json
Modules 3
Endpoints 19
Types 6
Endpoint sample
GET /pet/{petId}
200 -> Pet
Type sample
Pet
id: integer(int64)
name: string
status: available | pending | sold
Summary 3 Modules / 19 Endpoints / 6 Types
先查全 endpoint 和 type,再写调用代码。
把 Swagger UI、OpenAPI、Knife4j、FastAPI docs 或 Redoc 的地址贴进来。结果包含 module、endpoint、请求响应和可复用 type/schema,需要时可导出 Markdown 或 JSON。
- 当前 chat 只复用这个已确认的 source。
- 如果给了多个 source,先问清楚用哪一个。
- 只有明确传入 --config 时才读配置。
- token、cookie 和 Authorization 不写进输出。
Petstore 官方示例可能更新,实际数量以查询结果为准。
选客户端,复制安装命令。
Claude Code、Codex 和 npx skills 的安装入口不同。选中客户端后,代码块会显示对应命令。
升级 skill 后,请手动对比项目里的 CLAUDE.md 和 AGENTS.md;安装脚本会保留这两个文件。
/plugin marketplace add https://github.com/Jason-chen-coder/dev-skills
/plugin install dev-skills
文章里有需求、bug、验证和 commit。
文章保留完整例子,遇到具体问题时再看对应一篇。
从当前卡住的地方开始。
选一个 skill,处理完这一步,再看下一步。






