dotfiles
将代码审查文化固化为可执行的AI规则,实现从编写到审查的自动化合规。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:dotfiles。 它的用途是:将代码审查文化固化为可执行的AI规则,实现从编写到审查的自动化合规。 详细介绍见:https://321skill.com/skills/dotfiles-stevenmays/ 请根据该页面的说明完成安装。
使用示例
`/distill-standards`,它会自动分析自上次运行以来团队合并的所有PR,将审查评论提炼为新的编码规则或更新现有规则,并写入`.claude/standards.md`文件。下次你在这个仓库开始编码会话时,这些新规则会自动加载,指导你写出更符合团队标准的代码。
介绍
这个Skill旨在解决团队代码审查标准不一致、反馈难以沉淀、新人上手成本高的问题。它通过一个系统化的流程,将人类代码审查中的反馈自动提炼成具体的编码规则(.claude/standards.md),并在开发者编写代码的初始阶段就通过SessionStart钩子注入这些规则,确保代码在提交前就符合团队标准。
使用方式围绕几个核心命令:在新代码库中使用/onboard-repo初始化;日常开发中,/distill-standards命令会自动分析已合并PR的审查历史,将重复的反馈提炼为通用规则,将一次性的重要反馈记录为“注意事项”;提交代码前,使用/pre-review对照所有规则进行自查和自动修复;审查他人代码时,/review-pr命令会加载这些标准进行智能辅助。
它非常适合需要维持高质量代码规范、有持续代码审查实践的开发团队,尤其是全栈开发、后端开发和智能体开发者。对于追求代码一致性、希望将资深开发者的经验快速赋能给新成员的项目尤为有益。
建议在团队中逐步推广,先从核心仓库开始实践。注意,该Skill高度依赖GitHub的PR审查历史(通过gh CLI),且提炼的规则质量与历史审查的详细程度正相关。对于审查文化薄弱或PR描述简略的项目,初期可能需要手动补充规则。
核心特点
核心区别在于它构建了一个从“人类审查反馈”到“自动化编码规则”再到“编写时实时合规检查”的完整闭环,而不仅仅是静态的代码检查工具。它通过`distill-standards`动态地从真实的PR审查中学习并更新规则库,确保标准始终与团队最新的实践同步。
注意事项
不适合审查文化薄弱、PR描述和反馈过于简略或未使用GitHub进行规范代码审查的团队和项目。
常见问题
如何开始在一个新项目中使用?
在项目根目录运行`/onboard-repo`命令,它会引导你完成初始化,包括创建CLAUDE.md、分析现有代码生成初始标准,并配置本地设置。
`/distill-standards`会分析所有历史PR吗?
默认(不带参数)只分析自上次运行以来新合并的PR,进行增量更新,效率高。你也可以指定PR编号或使用`full`参数进行全量分析。