用途：本技能用于撰写指导 Claude 行为的指令，包括技能（Skills）、CLAUDE.md 文件、智能体提示词与系统提示词。使用时需同时应用 ed3d-extending-claude:prompt-security-hardening，因为演示不安全密钥处理的指令会教坏智能体泄露密钥。
核心原则：只写 Claude 不知道的内容，逐行质疑 token 成本；用正向表述替代否定表述（“不要做 X”会触发对 X 的联想）；用上下文解释“为什么”以促进合规；关键规则放在提示词开头和结尾；指令总量约 150 条上限，过多会导致所有规则均匀退化；高风险要求可用不同表述重复。
Token 效率：频繁加载的指令少于 200 词，技能/CLAUDE.md 总计少于 500 行；用 --help 代替罗列参数；交叉引用其他技能而非重复；采用渐进式披露，主文件为概览加链接，参考文件按需加载。
技能发现：description 字段决定 Claude 能否找到技能，格式为“Use when...”加具体触发条件与功能，用第三人称书写，包含错误信息、症状、工具名等关键词。
合规技巧：Claude 4.x 对指令高度敏感，优先用上下文加动机，其次用结构化强制（编号步骤、任务跟踪、强制声明、显式阻断），慎用命令式语气以免过度触发。按技能类型区分：纪律类用上下文加结构加堵漏，技术类用清晰步骤，参考类只需清晰。
结构模式：用 XML 组织任务、约束、输出格式与示例，XML 在长提示词中保留规则优于 markdown、JSON、YAML；提示词风格应与期望输出匹配；用工作流清单、反馈循环（验证→修复→重复）和自由度分级（脆弱操作用精确脚本，偏好模式用模板，依赖上下文用原则）。
其他要点：提供主动或保守的行动偏好模板；防止过度工程；Opus 4.5 在关闭扩展思考时对“think”敏感，可改用 consider、evaluate、determine；技能命名用动名词形式；避免冗长解释、模糊触发、深层嵌套引用、Windows 路径、对 4.x 使用激进语言；纪律类指令可加入反合理化红旗清单；通过基线测试、应用、迭代来测试指令。长时间运行任务与 Graphviz 流程规范见同目录参考文件。