Claude 写项目指令老踩坑？这个 Skill 直接给你决策树

还在为 Claude 写「项目指令 / Skill / 单次 prompt」而纠结用哪种？白鹿今天翻到一个把决策树直接喂给 Claude 的 skill——crafting-instructions，作者 oaustegard，仓库在 claude-skills 目录下，整个 repo 147 ⭐。

这个 skill 解决什么问题

很多人写 Claude 指令一上来就堆一段话，结果 Claude 经常「理解错格式」「该持久化的没持久化」「该复用的没抽出来」。crafting-instructions 直接把三种指令形式的判断逻辑写进 SKILL.md：

• Project Instructions（workspace 级，跨会话持久）：多人协作 / 单一项目背景知识 / 上下文要一直挂载
• Skill（跨项目可复用，自动触发）：你说「每次我…」「随时…」时用的那种能力封装
• Standalone Prompt（一次性，对话上下文内）：单次任务、单轮对话、不需要复用

它给了明确的 signals：「for this project」「all conversations about X」→ Project；「every time I」「whenever」「reusable」→ Skill；「for this task」「right now」→ Prompt。再加一个「Skill + Prompt 组合 / Project + Skill 组合」的实战套路。

比「技巧清单」更值钱的是原则

它的核心优化原则不只是 checklist，而是给 Claude WHY——

• Imperative Construction：把建议改写成命令。❌ “Consider creating X” → ✅ “Create X when conditions Y”
• Positive Directive：告诉 Claude 要做什么，不要只说不要做什么。❌ “Don’t use bullet points” → ✅ “Write in flowing paragraph form”
• Context and Motivation：每条规则配一个为什么——Sonnet 需要明确决策框架 + fallback；Opus 可以更战略化、信任它处理歧义。

最实用的一条：先告诉 Claude WHY，而不是 HOW。如果 Claude 能从目标推出步骤，就只给目标。

安装 & 使用

一行 clone：

git clone https://github.com/oaustegard/claude-skills
cp -r crafting-instructions ~/.claude/skills/

之后在 Claude Code / Claude.ai / Cursor 里提到「帮我写个项目说明」「我想做个可复用的 skill」「优化这个 prompt」它就会自动加载。三种格式该怎么选、怎么写、怎么避坑，全在 references/ 目录里——SKILL.md 主体不到 500 行，细节按需加载。

白鹿建议

如果你每天都在和 Claude 协作、写 AGENTS.md、维护项目说明——直接装一个。它不是 prompt 模板库，是「让 Claude 自己学会写好 prompt」的元 skill。装上之后你会发现：你写的 prompt 越来越短，但 Claude 干得越来越准。

🔗 GitHub: oaustegard/claude-skills

GitHub: https://github.com/oaustegard/claude-skills/tree/main/crafting-instructions