using-skills

概述

此技能要求严格遵循技能调用纪律，防止 Agent 走捷径绕过工作流，或为不使用现有框架寻找借口。它是抵御 AI 过度自信和偏离目标的核心防御机制。

铁律

IF THERE IS EVEN A 1% CHANCE A SKILL APPLIES, INVOKE IT AI 模型倾向于立即生成内容，而不是查阅参考资料。这条规则要求先“暂停并检查”，以避免生成质量低下、缺乏依据的内容。

状态机

digraph using_skills_flow {
    "Task Received" [shape=doublecircle];
    "Step 1: Check Skill Database" [shape=box];
    "Decision: Is it ≥ 1%?" [shape=diamond];
    "Step 2: Propose Skill to User" [shape=box];
    "Step 3: Apply Skill Logic" [shape=box];
    "Done" [shape=doublecircle];

    "Task Received" -> "Step 1: Check Skill Database";
    "Step 1: Check Skill Database" -> "Decision: Is it ≥ 1%?";
    "Decision: Is it ≥ 1%?" -> "Step 2: Propose Skill to User" [label="yes"];
    "Decision: Is it ≥ 1%?" -> "Done" [label="no"];
    "Step 2: Propose Skill to User" -> "Step 3: Apply Skill Logic";
    "Step 3: Apply Skill Logic" -> "Done";
}

何时使用此技能

• 收到新请求时。
• 正在进行的项目进入新阶段时（例如，从分析阶段转入交付阶段）。
• 发现自己正在“猜测”合适的方法时。

何时不使用此技能

• 不涉及策略或创意的简单事实查询。
• 基本的日常闲聊。

核心流程

第 1 步：扫描适用技能

检查涵盖 6 个类别的 41 项技能分类。不要依赖记忆；使用分类来识别可能适用的技能。（来源：系统设计）

第 2 步：应用 1% 规则

询问：“[skill-name] 是否有哪怕 1% 的可能性可以改善此任务的结果？”如果有，就必须提及该技能。（来源：系统设计）

第 3 步：向用户提供选项

明确说明哪些技能适用，以及它们能带来什么价值。不要替用户做决定；应将其作为专业建议提出。（来源：系统设计）

第 4 步：严格执行

选定技能后，你必须严格遵循其状态机和铁律，不得例外。（来源：系统设计）

跨技能调用

必需的子技能：getting-started — 用于获取初始会话上下文。 推荐的子技能：prompt-optimizer — 用于优化其他技能的调用方式。

合理化借口对照表

想法	事实
“用户没有要求使用技能，所以我不会使用。”	用户可能不知道有哪些可用技能。向用户推荐技能是你的职责。
“这项任务与技能描述略有不同。”	使用 1% 规则；即使只是部分匹配，也比完全没有结构更好。
“我已经用了三项技能，再加一项会太复杂。”	复杂问题往往正需要这种复杂度。
“我可以只应用技能的原则，不正式调用它。”	只有正式调用才能确保遵循状态机和铁律。

危险信号

出现以下想法时，意味着必须停下来——你即将走捷径：

• “我就手动处理这一次” → 你在规避 1% 规则。
• “这个小请求用这种技能太过了” → 越是小请求，框架越能发现隐藏错误。
• “我手边没有该技能的资料” → 你应该使用提取方法来查找资料。

诊断清单

• 我是否检查了与此任务相关的完整 41 项技能列表？
• 我是否正确应用了 1% 规则？
• 我是否解释了推荐技能的理由？
• 我是否遵循了所调用技能的状态机？
• 我是否克制住了“凭感觉行事”的冲动？

来源

• 系统设计 — 1% 规则。
• 系统设计 — 合理化防御。
• 系统设计 — 铁律注册表。