dev-skills

AI development workflow skills

从需求到提交,
每步可验证。

dev-skills 为 Claude Code 与 Codex 提供 9 个工程流程 skill 和精简 always-on 团队规则,让需求、实现、验证、评审与收尾都有清晰边界和可复核结果。

Install Preview GitHub
codex cli 
$ codex
> 用 dev-auto 帮我串起来,下一步该做什么?

━━━ Dev Auto ━━━
路径   : feature
复杂度 : moderate
下一步 : dev-spec --default user-export

Skill library

9 个 skill,每个只做一件事。

把它当成开发导航:不确定下一步就问 dev-auto。做新功能从 dev-spec 开始,再到 plan、TDD、verify、review、finish;修 bug 从 dev-fix 开始,同样经过 verify 和 review 收尾;只需要提交信息时用 dev-commit-writer。

入口推荐

dev-auto

不知道下一步该跑哪个时,扫描 artifacts 并推荐下一条命令。

Artifact: none
需求对齐

dev-spec

先暴露歧义,再把模糊需求整理成 scope、风险和验收标准。

Artifact: designs/<slug>.md
实施方案

dev-plan

把 spec 转成 RALPLAN-DR 方案,包含选项、ADR 和 Critic 验证。

Artifact: plans/<slug>.md
红绿重构

dev-tdd

写生产代码前先定义行为测试,按 red -> green -> refactor 收敛。

Artifact: none
Bug 修复

dev-fix

以 failing test 和 root cause 为核心,避免猜测式 symptom patch。

Artifact: fixes/<slug>.md
完成门禁

dev-verify

声称完成前补齐 fresh evidence,把“应该可以”变成可验证结果。

Artifact: none
提交前 review

dev-code-review

按规范、功能、闭环、注释、废码 5 轴检查当前 diff。

Artifact: none
提交信息

dev-commit-writer

只在明确跳过 review 且只要 message 时,生成符合仓库风格的提交信息。

Artifact: none
分支收尾

dev-finish

验证和 review 后处理 PR、merge、keep 或 discard,避免口头收尾。

Artifact: none

Rules layer

常驻规则变短,解释和政策各归其位。

这次更新把模板从团队治理手册压回 agent 必须常驻读取的短规则,同时新增 rationale 和 policy 文档,让规则可解释、可传播、可维护。

Always-on

CLAUDE.md / AGENTS.md

短版团队规则,只保留 baseline、硬规则、agent 工作方式、skill 路由和少量 team-specific placeholder。

Why

docs/why-dev-baseline.md

逐条解释“不假设、最小代码、外科手术式、可验证成功标准”关闭的失败模式。

Policy

docs/team-policy.md

承接分支、PR、测试、错误处理、日志、feature flag 和 AI 协作护栏等详细治理说明。

Runtime preview

像真实 Codex CLI 一样看 skill 怎么跑。

切换 tab 查看用户输入和代表性输出。左侧输入会播放打字机效果;开启减少动效时直接显示完整文本。

codex cli 
$ codex
> 用 dev-auto 帮我串起来,下一步该做什么?
Dev Auto
━━━ Dev Auto ━━━
路径   : feature
复杂度 : moderate
下一步
  $ dev-spec --default user-export
为什么:先把模糊需求拆成可验证 spec。

Workflow

两条主路径,最后都回到提交前 review。

Feature path

  1. dev-spec模糊需求变成 spec
  2. dev-plan复杂改动先出实施方案
  3. code按 spec / plan 实现
  4. dev-code-review提交前 5 轴检查
  5. commitREADY 后提交

Bug path

  1. dev-fix复现、假设、定位 root cause
  2. code/fix只改根因路径
  3. verifyred -> green -> red
  4. dev-code-review确认无回归和夹带改动
  5. commit记录修复上下文
Start 用户需求 功能 / Bug / 提交 进入工作流
Route dev-auto 入口推荐器 不知道下一步,先问它
Decision 路径分流 feature / bug 选择处理路径
Feature dev-spec 模糊需求 → 结构化 spec 写代码前对齐需求
Plan dev-plan spec → Critic-approved plan 复杂功能,先出方案
Build code 按 spec / plan 实现 写代码
Bug dev-fix Hypothesis-driven 调试 修 bug / 排查
Verify red → green 复现、修复、反证 回归验证
Patch code/fix 只改确认根因 最小修复
Review dev-code-review 5 轴评审 + 自动 Refs 追溯 准备 commit
Ship git commit 提交代码到仓库 记录变更

Install and upgrade

Claude Code 和 Codex 分开安装。

选择你的入口,复制对应命令。升级 skill 不会自动覆盖项目里的短版团队规则模板;详细政策可参考或复制 `docs/team-policy.md`。

Claude Code

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

升级: `/plugin update dev-skills`。短版团队规则复制 `CLAUDE.md.template` 到项目根 `CLAUDE.md`;详细政策参考 `docs/team-policy.md`。

FAQ

常见问题。

Claude Code 和 Codex 为什么安装方式不一样?

Claude Code 使用 `.claude-plugin/` manifest;Codex 当前兼容方式是复制 `skills/*` 到 `$CODEX_HOME/skills`。

升级会覆盖我的 `CLAUDE.md` 或 `AGENTS.md` 吗?

不会。skill 升级只更新 skill 文件,短版团队规则模板需要人工对比后同步;详细 policy 文档也建议按团队实际情况复制或改写。

`docs/why-dev-baseline.md` 和 `docs/team-policy.md` 分别解决什么?

前者解释四条 baseline 背后的失败模式,防止规则变口号;后者放详细团队治理,避免把 always-on 模板写得过长。

什么时候用 `dev-auto`?

当你不知道下一步跑哪个 skill,或者需要从失败状态恢复时使用。它只建议,不调起其他 skill。

准备 commit 时为什么默认走 `dev-code-review`?

团队策略是 commit 前先 review。`dev-commit-writer` 只用于用户明确表示跳过 review 且只要 message 的场景。