GitHub - Jason-chen-coder/dev-skills: 团队 git 工作流Skills(Team Git Workflow Skills)

9 个 skill 覆盖团队 git 工作流 ·
需求对齐 → 实施方案 → TDD / 修复 → 验证 → 代码评审 → 分支收尾

Website · Onboarding · Start with dev-auto

Skills

	Skill	一句话职责	触发
🧭	`dev-auto`	入口推荐器,不调起任何 skill	不知道下一步 / 失败恢复
📋	`dev-spec`	模糊需求 → 结构化 spec	写代码前对齐需求
🏗	`dev-plan`	spec → Critic-approved 实施 plan	复杂功能,写代码前
🧪	`dev-tdd`	红绿重构编码循环	写生产代码前
🐛	`dev-fix`	Hypothesis-driven 调试 + 修复	修 bug / 排查
✅	`dev-verify`	完成前证据门禁	声称完成 / ready 前
🔍	`dev-code-review`	5 轴评审 + 自动 Refs 追溯	准备 commit
✏️	`dev-commit-writer`	跟随仓库风格生成 commit message	改动已过审
🚢	`dev-finish`	merge / PR / keep / discard 分支收尾	验证和 review 后

_{每个 skill 只做一件事 · 通过 .claude/artifacts/ 松耦合 · 不互相调用}

规则分层

dev-skills 的规则分三层:

references/dev-baseline.md:四条最小行为基线,所有 skill 都加载。
docs/why-dev-baseline.md:解释每条 baseline 关闭的真实失败模式,避免规则变口号。
CLAUDE.md.template / AGENTS.md.template:短版 always-on 团队规则;详细治理说明放 docs/team-policy.md。

🚀 安装

Claude Code 和 Codex 的安装方式不一样:

Claude Code 走本仓库的 .claude-plugin/ manifest,用 /plugin marketplace add + /plugin install。
Codex plugin 发布形态已补齐在 .codex-plugin/plugin.json;正式上架前,仍可用下方兼容方式把 skills/* 安装到 $CODEX_HOME/skills。

Claude Code

在 Claude Code 里逐行执行:

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

Codex

本仓库已包含 .codex-plugin/plugin.json,可用于 Codex plugin 打包 / 发布流程。正式上架前,本地兼容方式仍是在 shell 里把 skill 目录复制到 Codex skills 目录:

git clone https://github.com/Jason-chen-coder/dev-skills.git
cd dev-skills
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R skills/* "${CODEX_HOME:-$HOME/.codex}/skills/"

Codex 用户如果需要团队级 always-on 规则,可以复制 AGENTS.md.template 到项目根的 AGENTS.md。

npx skills

跨 agent CLI 安装方式:

npx skills add Jason-chen-coder/dev-skills              # 项目级
npx skills add Jason-chen-coder/dev-skills --global     # 全局

团队规则模板

Claude Code 用户别忘了手动复制团队约定模板到项目根。模板刻意保持短,只放 agent 必须常驻读取的硬规则;分支、PR、测试、错误处理等细则见 docs/team-policy.md。

curl -O https://raw.githubusercontent.com/Jason-chen-coder/dev-skills/master/CLAUDE.md.template
mv CLAUDE.md.template CLAUDE.md

Codex 用户复制 Codex 团队规则模板:

curl -O https://raw.githubusercontent.com/Jason-chen-coder/dev-skills/master/AGENTS.md.template
mv AGENTS.md.template AGENTS.md

_{完整安装 / 兜底方案 / 升级路径 → docs/onboarding.md}

🔄 升级

升级方式取决于你当初怎么安装。

Claude Code

在 Claude Code 里执行:

/plugin update dev-skills

如果 update 后没有生效,用卸载重装兜底:

/plugin uninstall dev-skills
/plugin install dev-skills

Codex

当前 Codex 兼容方式是复制 skills/* 到 $CODEX_HOME/skills,所以升级时需要重新同步全部 skill 目录:

cd dev-skills
git pull --ff-only

CODEX_SKILLS_DIR="${CODEX_HOME:-$HOME/.codex}/skills"
mkdir -p "$CODEX_SKILLS_DIR"

for skill in dev-auto dev-spec dev-plan dev-tdd dev-fix dev-verify dev-code-review dev-commit-writer dev-finish; do
  rm -rf "$CODEX_SKILLS_DIR/$skill"
done

cp -R skills/* "$CODEX_SKILLS_DIR/"

如果本地没有保留 dev-skills clone,重新跑一遍 Codex 安装步骤即可。

npx skills

如果使用 npx skills 安装,优先使用 update:

npx skills update

如果你的 npx skills 版本没有 update,或遇到目录结构迁移 / skill 重命名,用 force 重新安装:

npx skills add Jason-chen-coder/dev-skills --force              # 项目级
npx skills add Jason-chen-coder/dev-skills --global --force     # 全局

模板同步

升级 skill 不会自动覆盖你项目里的 CLAUDE.md / AGENTS.md。如果本仓库的 CLAUDE.md.template 或 AGENTS.md.template 有更新,需要人工对比后把需要的短规则同步到项目根对应文件;详细政策变化参考 docs/team-policy.md。

💡 使用

直接在对话里按需触发 skill,或先跑 dev-auto 让它指路:

/dev-auto                # 不知道下一步,先问它
/dev-spec    新需求描述...    # 需求对齐 → 产出 spec
/dev-plan    spec 路径        # spec → 实施 plan
/dev-tdd                     # 写生产代码前走红绿重构
/dev-fix     bug 现象...       # hypothesis-driven 修 bug
/dev-verify                  # 声称完成 / ready 前跑证据门禁
/dev-code-review              # 提交前 5 轴评审
/dev-commit-writer            # 改动已过审,只要 commit message
/dev-finish                   # 验证和 review 后做分支收尾

🗺 架构总览

flowchart LR
  Baseline["references/dev-baseline.md<br/>四条行为基线"]
  Why["docs/why-dev-baseline.md<br/>failure mode rationale"]
  Policy["docs/team-policy.md<br/>详细团队治理"]
  Team["CLAUDE.md.template / AGENTS.md.template<br/>短版 always-on 规则"]
  Workflow["dev-auto<br/>只指路,不调起"]

  Why --> Baseline
  Baseline --> Team
  Policy --> Team
  Team --> Workflow
  Workflow --> Spec["dev-spec"]
  Workflow --> Plan["dev-plan"]
  Workflow --> TDD["dev-tdd"]
  Workflow --> Fix["dev-fix"]
  Workflow --> Verify["dev-verify"]
  Workflow --> Review["dev-code-review"]
  Workflow --> Commit["dev-commit-writer"]
  Workflow --> Finish["dev-finish"]

🔄 工作流

flowchart TD
  Start["用户请求"] --> Kind{"路径?"}

  Kind -->|Feature / 增强| Spec["dev-spec"]
  Spec --> NeedPlan{"复杂 / 高风险?"}
  NeedPlan -->|是| Plan["dev-plan --deliberate"]
  NeedPlan -->|否| TDD["dev-tdd"]
  Plan --> TDD

  Kind -->|Bug / 事故| Fix["dev-fix"]
  Fix --> Verify["dev-verify"]

  Kind -->|简单 hotfix| TDD
  TDD --> Verify

  Verify --> Review["dev-code-review"]
  Review --> Ready{"READY?"}
  Ready -->|否| Rework["修复 review finding"]
  Rework --> Verify
  Ready -->|是| GitCommit["git commit"]
  GitCommit --> Finish["dev-finish"]

松耦合保证:dev-auto 是纯建议器,绝不调起任何 skill。其他 8 个 skill 的「不互调」Hard rule 100% 有效。

📂 中间产物路径 + 自动 Refs 追溯

Skill	Artifact
`dev-spec`	`.claude/artifacts/designs/<feature>.md`
`dev-plan`	`.claude/artifacts/plans/<feature>.md`
`dev-fix`	`.claude/artifacts/fixes/<slug>.md`
`dev-auto` / `dev-tdd` / `dev-verify` / `dev-code-review` / `dev-commit-writer` / `dev-finish`	无 artifact,只输出到 chat

dev-commit-writer 和 dev-code-review(READY 时)会扫 .claude/artifacts/,在 commit message footer 自动加 Refs: <type>/<slug>。后续可用 git log --grep="Refs:" 检索 commit ↔ artifact 关联。

🚦 模式建议

场景	推荐
复杂功能(鉴权 / 支付 / 数据迁移 / PII)	`dev-spec` + `dev-plan --deliberate`
间歇性 / 生产事故 / 跨系统 bug	`dev-fix --deep`
feature / refactor / 直接 hotfix 写生产代码	`dev-tdd`
声称完成 / ready	`dev-verify`
一句话 hotfix	跳过 spec/plan,但仍走 `dev-tdd` → `dev-verify` → `dev-code-review`
分支收尾	`dev-finish`
不知道该跑哪个	`dev-auto`

🛑 失败回路(terminal status)

Skill	Terminal status
`dev-spec`	`STUCK`
`dev-plan`	`BELOW_CONSENSUS_THRESHOLD`
`dev-fix`	`BELOW_CONFIDENCE_THRESHOLD` / `NEEDS_DESIGN_CHANGE`

任何 skill 卡住时,跑 dev-auto --recover [slug],它有完整决策表覆盖各阻塞的恢复路径。

📜 版本历史

详见 CHANGELOG.md。

_{MIT License · CHANGELOG · Contributing · Issues}

_{灵感来自 karpathy-skills · oh-my-claudecode}

Name		Name	Last commit message	Last commit date
Latest commit History 24 Commits
.claude-plugin		.claude-plugin
.codex-plugin		.codex-plugin
.github/workflows		.github/workflows
docs		docs
images		images
references		references
scripts		scripts
site		site
skills		skills
.gitignore		.gitignore
.nojekyll		.nojekyll
AGENTS.md.template		AGENTS.md.template
CHANGELOG.md		CHANGELOG.md
CLAUDE.md.template		CLAUDE.md.template
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
index.html		index.html

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Skills

规则分层

🚀 安装

Claude Code

Codex

npx skills

团队规则模板

🔄 升级

Claude Code

Codex

npx skills

模板同步

💡 使用

推荐链路

🗺 架构总览

🔄 工作流

📜 版本历史

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

路径	推荐链
Feature / 增强	`dev-spec` → 可选 `dev-plan` → `dev-tdd` → `dev-verify` → `dev-code-review` → `git commit` → `dev-finish`
Bug / 事故	`dev-fix` → `dev-verify` → `dev-code-review` → `git commit` → `dev-finish`
简单 hotfix	`dev-tdd` → `dev-verify` → `dev-code-review` → `git commit`

Folders and files

Latest commit

History

Repository files navigation

Skills

规则分层

🚀 安装

Claude Code

Codex

npx skills

团队规则模板

🔄 升级

Claude Code

Codex

npx skills

模板同步

💡 使用

推荐链路

🗺 架构总览

🔄 工作流

📜 版本历史

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages