REUSABLE SKILLS

dev-skills

把解释与代码评审的方法,写成 Agent 可以复用的指引。
从理解一个技术概念,到判断一条 Review 建议是否成立。

介绍复核于 · 查看依据版本 4b46de8

把方法留下来

有些要求会在开发中反复出现:解释概念时从基础讲起;评审代码时交代问题的依据。这个仓库把它们整理成可手动调用的 Skills,在需要时应用到当前任务。

当前公开的两个 Skill 分别用于概念解释和评审。它们提供工作指引,输出质量仍需要结合具体任务检查。

01 / 解释清楚

explain-as-fool

适合刚接触一个技术概念、希望从基础理解它的场景。在支持的宿主中显式调用,再给出你想弄懂的问题。

$explain-as-fool 解释一下什么是线程池

说明示例,非真实运行输出:可以先把线程池理解为一组可重复接活的工作线程。任务来了先排队,空闲线程再取走执行;接着需要解释线程数、队列容量和拒绝策略分别影响什么。

02 / 评审有依据

review-rules

用于代码、设计,以及已有评审建议的复核。准则关注正确与完整、最少的必要改造、复杂度与收益、具体的扩展需要,以及清晰的责任边界。

$review-rules 复核这条建议:
“这里应该增加一个通用重试层。”
请结合当前需求、已有实现和失败场景判断。

复核思路示例,非真实评审结果:先找出会失败的调用及触发条件,再确认调用是否幂等、现有层是否已经重试。证据明确以后,再比较局部修复与通用封装的成本。

怎样用得更好

先明确任务范围,再调用需要的 Skill。例如评审哪个分支、是否允许修改、最终要交付什么。Skill 会沿用当前任务的范围与执行要求。

仓库 README 给出了 Codex 的 $skill-name 和 Claude Code 的 /skill-name 调用示例。安装位置和实际支持情况请以宿主及仓库文档为准。