Skip to content

hydrz/dev-skills

v0.8.1MIT

面向中文开发者的软件工程 Agent Skills,覆盖方案澄清、规格与任务拆分、TDD、系统化调试、代码评审、并行实现和完成验证。

api-contract

用于接口契约设计(api contract)、通信协议选型(REST/RPC/GraphQL)、参数校验与统一错误结构规范。

ask-dev-skills

不确定下一步该使用哪个 skill 时,说明当前情况并获得工作流建议。本仓库所有 skill 的导航入口。

bootstrap-project

全新项目从零起步时,按决策清单完成技术栈选型、目录分层与工具链配置;区别于配置工程约定的 setup-dev-skills。

code-review

用于代码评审(code review)、评审 PR,或检查一组提交和 diff。

codebase-design

用于模块设计(codebase design)、测试接缝与可测性,以及 DDD、限界上下文、模块化单体或 vertical slice 的结构取舍。

data-modeling

用于数据库表结构设计(与管理业务术语的 domain-modeling 相对)、ORM 与迁移工具选型及种子数据规划(data modeling)。

diagnosing-bugs

用于诊断(debug)疑难 bug、测试失败、性能退化和偶发问题;用户附报错或堆栈请求修复时也触发。

domain-modeling

用于业务领域概念与术语建模(与管理数据库表结构的 data-modeling 相对)、维护 CONTEXT.md 及 ADR。

finish-work

实现、代码评审与完成验证都通过后,把功能分支收尾:合并、提交评审或保持现状,安全清理工作树与分支。

git-guardrails

配置跨平台、宿主中立的本地 Git 防破坏拦截(阻断强推、硬重置、强制清理与强删分支等不可逆操作)。

grill-me

逐轮澄清并压力测试一个计划或设计,在对话中推演方案,无需写入项目文件时使用。

grill-with-docs

逐轮澄清并压力测试一个计划或设计,同时就地创建或更新仓库文档(ADR 和术语表)。

grilling

用于逐轮追问、盘问或挑刺计划、设计和决策直到达成共识(grill me),以及实施前仍有关键决策未确认时;挑刺代码属于代码评审,不触发。

handoff

将当前对话中的背景、决定、证据和后续动作整理成交接文档,供另一个 agent 继续工作。

implement

在当前会话实现一项或少量已明确的开发任务。整份规格需要由多个子代理并行交付时使用 implement-spec。

implement-spec

由多个子代理并行完成整份规格,在磁盘记录进度并最终统一评审,交付整份规格的 PR 或在本地完成。少量任务在当前会话完成时使用 implement。

improve-codebase-architecture

扫描代码库中接口复杂、职责分散或边界不清的位置,生成可视化 HTML 审查报告,再与用户深入讨论选中的改进项。

pr

用于撰写结构化 PR 描述(pr body),包含伪代码或调用树摘要、Before/After 证据对比与合并风险评估。

prototype

用于通过一次性原型回答设计问题(prototype)。当需要快速验证状态模型或业务逻辑是否合理,或者探索 UI 界面应该是什么样时使用。

receiving-code-review

用于处理代码评审意见(receiving code review),尤其是意见含糊或可能不适用于当前代码时。

research

用于用户明确要求在仓库中留下带引用的技术调研报告(research report)时;一次性查文档或核实 API 行为直接回答,不触发。

resolving-merge-conflicts

用于解决合并冲突(resolve conflicts),或继续发生冲突的 Git merge 和 rebase。

retro

回顾一次已经结束的 agent 编程会话,把真实发生的绕路、遗漏和重复劳动转化为自动检查、评审规则或精简的仓库指引。

setup-deep-modules

为已经存在明确模块边界的代码库配置可执行的边界与循环依赖检查,让跨模块调用只经过明确的公开入口。

setup-dev-skills

首次在仓库中使用工程 skill 前,配置 issue 追踪器、分诊标签、领域文档布局和功能清单约定。每个仓库通常只需运行一次。

setup-pre-commit

为仓库配置只检查暂存改动的 pre-commit 质量门,沿用现有包管理器、格式化器、测试命令和 Git hook 工具。

tdd

用于通过测试先行(TDD、test-driven development)实现功能或修复 bug;普通的集成测试请求不触发。

teach

将当前目录作为可持续记录进度的学习工作区,通过多次会话帮助用户掌握一项技术或概念。

to-questionnaire

将必须由其他人提供的信息和决策整理成一份可直接发送、填写和回收的问卷。

to-spec

将当前对话与讨论成果综合整理为一份可实施规格,并发布到项目的 issue 追踪器。不再追加访谈,只综合已有讨论。

to-tickets

将计划、规格或当前对话拆成一组声明前置依赖的端到端最小闭环任务(曳光弹),并发布到已配置的 issue 追踪器。

triage

对外部 issue 和 PR 进行分类、核实和必要的追问,补齐复现证据与验收条件,并整理成可由 agent 执行的说明。

verifying-completion

用于完成验证(verify completion),以及声明修复或测试通过、提交、创建 PR、核实子代理结果之前。

wait-what

当上一段说明难懂、术语过多或前提跳跃时,用更平实的语言和更少的假设重新解释。

walking-skeleton

搭建贯穿前端到数据库的端到端最小可运行系统雏形,作为后续正式开发的基座;区别于分支不合并进主干的 prototype。

wayfinder

将单个 agent 会话无法理清的大型工作拆成一组相互关联的决策问题,并通过 issue 追踪器逐步解决,直到后续执行路径明确。

wizard

用于为外部配置、凭据、CI 密钥或人工迁移生成交互式设置向导(setup wizard)。

workflow-designer

把重复发生的团队操作、审批循环、发布检查或内容流程整理成可实施的工作流规格,明确触发、输入、状态、动作、检查点和责任人。

writing-chinese

用于面向中文读者构思、撰写、改写、翻译或审校成篇内容(Chinese writing/editing);普通短对话不触发。

writing-for-agents

用于编写、修改或测试 agent 指令,包括 skill、AGENTS.mdCLAUDE.md 和上下文指针。