高可靠 Agent Skill 的设计原则

高可靠的 Agent Skill 应采用“最小必需、按需扩展”的结构：仅保留必需的 SKILL.md，根据实际需要添加 scripts/ 和 references/，避免为形式完整而创建空目录。description 是唯一常驻系统提示的部分，必须同时说明技能做什么以及何时触发，但不应包含流程摘要，以免 Agent 跳过正文。 Skill 的正文应围绕可执行行为组织：用具体命令替代笼统要求，用反向排除条件辅助激活判断，用 Common Rationalizations 预先反驳 Agent 可能跳过步骤的借口，并通过 Red Flags 和 Verification 定义可观察的违规信号与基于证据的退出标准。 脚本应将结构化 JSON 输出到 stdout、状态信息输出到 stderr，并使用 set -e 快速失败。由于执行脚本本身不消耗上下文，只有输出会消耗上下文，因此应优先把重复或复杂逻辑放入脚本，并将 SKILL.md 控制在约 500 行以内、引用层级限制为一层。核心原则是：流程优于知识、具体优于笼统、证据优于假设、预防合理化、渐进披露和持续关注 Token 成本。