Code Craftsmanship Skills 

用结构化技能，让 AI 编程 Agent 写出人类真正愿意维护的代码。

https://github.com/chaocai2001/craftman-skills

我要解决的问题

“Vibe Coding”——也就是在没有工程纪律约束的情况下，让 AI Agent 直接生成代码——刚开始看起来很快，直到你不得不面对这些问题：

• 评审一个 500 行的函数：没有任何测试，变量名还晦涩难懂。

• 调试一个由 Agent 引入的回归问题：它只是想把你的整个模块“清理一下”，结果却重写了一遍。

• 扩展一个代码库：每个文件都遵循不同的模式、约定和架构哲学。

• 带新人入职：他不得不反向工程一堆 AI 生成的“意大利面条代码”。

速度只是幻觉，技术债才是真实的。

这个仓库就是为了解决这个问题而存在的。

这是什么

这是一组 Agent Skills（智能体技能）——也就是给基于 LLM 的编程 Agent（如 Claude Code、OpenCode、Codex、Cursor 等）使用的结构化指令集。

每个技能都把经过实战验证的软件工程原则，编码成可执行的行为规则。你可以把它们理解为：

• 一位资深工程师在你的 Agent 耳边提醒。

• 一套内置到提示词层的代码评审清单。

• 一道防御 Vibe Coding 的结构化约束。

为什么是技能，而不只是提示词？

提示词只是一次性的指令；而技能是：

• 可复用的：可以跨项目、跨 Agent 使用。

• 可版本管理的：让团队的编码标准可以有意识地演进。

• 可组合的：按需组合 code-craftsmanship + security-review + performance-budget 等技能。

• 可审计的：当 Agent 产出糟糕代码时，你可以追溯到缺失或不够强的技能，而不是一句模糊的提示词。

参与贡献

欢迎能解决真实工程痛点的技能。提交之前，请先确认：

1. 先自己用起来（Dogfood）。至少用这个技能完成 5 个真实编码任务。

2. 量化改进效果。输出是否真的变好了？请在 examples/ 中分享前后对比的 diff。

3. 保持可执行。好的技能应该告诉 Agent“要做什么”，而不只是“应该重视什么”。

“想走得快，唯一的办法就是走得好。”
—— Robert C. Martin