dev-skills

需求、bug、验证,找 skill。

给 Claude Code 和 Codex 用,也能查 Swagger、还原 UI、检查 commit。

codex cli Workflow
$ 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 是否能提交。

  1. 需求

    dev-grill-docs
    dev-design-context

    确认术语、边界和验收条件;做 UI 时先补设计上下文。

  2. 方案

    dev-plan

    改动复杂或风险高时,再写文件范围、取舍和验证命令。

  3. 实现 / 修复

    dev-tdd
    dev-fix

    新功能先写失败测试;bug 先复现,再追 root cause。

  4. 验证

    dev-verify

    运行本次改动需要的命令,原样记录通过项和失败项。

  5. 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 或分支收尾。
swagger-doc-skillPetstore
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.mdAGENTS.md;安装脚本会保留这两个文件。

/plugin marketplace add https://github.com/Jason-chen-coder/dev-skills
/plugin install dev-skills

文章里有需求、bug、验证和 commit。

文章保留完整例子,遇到具体问题时再看对应一篇。

AI 写代码越快,越要先给它装上刹车

AI 写代码越快,越要先给它装上刹车

为什么 AI 写完代码后,不能直接 commit

为什么 AI 写完代码后,不能直接 commit

别被已修复骗了:AI 修 bug 最该追问这一句

别被“已修复”骗了:AI 修 bug 最该追问这一句

从需求到 commit:一套更稳的 AI 编程工作流

从需求到 commit:一套更稳的 AI 编程工作流

AI 越会写代码,越不能让它直接写到 commit

AI 越会写代码,越不能让它直接写到 commit

AI 编程最危险的瞬间:它还没听懂,就已经开始写了

AI 编程最危险的瞬间:它还没听懂,就已经开始写了

从当前卡住的地方开始。

选一个 skill,处理完这一步,再看下一步。