Claude写避坑清单提示词如何让AI先给提纲

必须先输出四类维度提纲：权限越界类 代码注入类 上下文截断类 配置漂移类；每类下列出3个典型子项（只列标题）；禁用Markdown、编号、缩进；若含解释性文字则立即删除，仅保留纯文本四行标题式子项。

你需要让Claude生成一份真正能落地执行的避坑清单，但直接让它“写一份避坑清单”往往产出空泛条目——比如“注意权限设置”“避免盲目提交”，既没说明谁在什么场景下踩了什么坑，也没给出可验证的检查动作。这类清单打印出来贴在工位上，三天后就被咖啡渍盖住了。

先让Claude输出结构化提纲

在输入任何具体避坑内容前，强制它先交出带分类逻辑的骨架。这一步不是可选项，是防止AI用常识拼凑的防火墙。

输入指令：请严格按以下四类维度拆解避坑清单，每类下列出3个典型子项（只列标题，不展开）：① 权限越界类（如IDE插件读取.gitconfig）、② 代码注入类（如AI重写commit hook脚本）、③ 上下文截断类（如长函数体被自动省略关键参数）、④ 配置漂移类（如本地Docker镜像版本与CI环境不一致）。输出格式为纯文本，禁用Markdown、编号、缩进符号。

这一步操作起来很简单，直接把上面整段复制粘贴就行。Claude若开始解释“为什么分这四类”，说明它没执行指令——立刻中断对话，删掉所有解释性文字，只保留四行标题式子项。

用失效案例锚定每个子项

拿到提纲后，立即用真实失效场景给每个子项“打钉子”。不能只说“权限越界”，必须绑定具体行为链。

方法一：逐条填充
在提纲第①类“权限越界类”下方，插入案例：某团队启用Cursor后，AI自动将包含AWS密钥的debug日志片段写入commit message，触发CI/CD密钥扫描告警。
方法二：批量喂入
把三个失效案例一次性粘贴在提纲末尾，加一句：“请将以上案例分别归入提纲中对应的子项，并为每个匹配项补充：a)触发该问题的默认行为开关名称、b)对应的安全配置路径、c)验证是否生效的终端命令。”【必须写明“终端命令”，否则Claude会用模糊描述代替可执行动作】

锁定输出动作动词

避坑清单不是知识罗列，是动作指令集。Claude天然倾向用“应”“需”“建议”等弱动词，必须用硬性规则把它拽回来。

第一步：删除所有“应”“需”“建议”“可以”字眼
第二步：把每条避坑项改写成“停用XX开关”“运行grep -r 'autoCommit' ~/.cursor/”“将FROM指令从node:16-alpine改为node:20-slim”
第三步：检查每条是否含一个可执行动词（停用/运行/替换/禁用/删除），不含则重写

这一步做完，清单就从“看看就算了”变成“打开终端就能干”。