code-craft
一套通过TDD方式开发的代码规范技能，帮助AI编码代理写出更高质量的代码。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：code-craft。 它的用途是：一套通过TDD方式开发的代码规范技能，帮助AI编码代理写出更高质量的代码。 完整的 Skill 内容见：https://321skill.com/skills/code-craft/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘为这个用户服务类添加一个发送邮件通知的功能。’，它会优先考虑单一职责原则，建议将邮件功能分离到独立的服务类中，而不是直接修改现有类。或者
对AI说：‘处理这个API请求时，如果参数无效就直接返回null吧。’，它会应用Fail Fast原则，建议立即抛出清晰的异常，而不是返回null导致后续的隐蔽错误。
介绍
Code Craft 是一套旨在提升AI编码代理代码质量的技能集合。它针对AI在编程时常见的坏习惯和模式，通过一系列具体的技能文档进行“训练”，使AI能够抵抗来自用户的“赶工”压力，遵循软件工程的最佳实践，从而生成更健壮、可维护的代码。
这套技能通过一个统一的命令行工具安装，支持包括OpenCode、Claude Code、Cursor在内的多种主流AI编码代理。用户可以选择安装全部技能，也可以根据当前项目需求，只安装特定的原则（如SOLID、DRY、YAGNI等）或领域（如测试、安全、API设计）技能到指定的代理上。
它非常适合所有需要AI辅助编写代码的开发者，尤其是前端开发、后端开发、全栈开发和智能体开发者。当开发者希望AI不仅仅是“完成任务”，而是能写出符合团队规范、具备良好架构的代码时，这套技能尤为有用。
使用建议：建议在项目初期或重构阶段安装相关技能，以建立良好的代码基础。对于小型或一次性脚本，可能无需启用所有技能。可以先用 --list 命令查看所有可用技能，再根据项目特点（如Web开发、API设计、安全敏感）选择安装。
核心特点
与普通代码规范文档不同，这些技能采用“TDD for documentation”方法开发，即先测试AI在无指导时的典型失败模式，再针对性编写技能来“堵住漏洞”，因此能更有效地纠正AI的特定错误倾向和“偷懒”借口。
注意事项
不适用于编写一次性、无需维护的快速原型或脚本，过度使用可能增加初期编码的认知负担。
常见问题
如何只安装SOLID原则相关的技能？
使用命令：npx add-skill yanko-belov/code-craft -s single-responsibility open-closed liskov-substitution interface-segregation dependency-inversion
支持哪些AI编码工具？
支持OpenCode, Claude Code, Codex, Cursor, Antigravity, GitHub Copilot, Roo Code等主流代理。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/code-craft/raw/index.md 读取 code-craft 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/code-craft/raw/index.md（查看排版版本）