Zc Using Agent Skills

技能发现

何时使用

会话开始或不确定入口时使用。用最少上下文选中当前阶段真正需要的 skill：先读 metadata，选中后再读正文；不要把整个技能目录加载进会话。

路由

任务跨阶段时按需切换，不把前一阶段的完整正文继续留作当前规则。

Discovery Contract

判断候选 skill 时只看：

1. WHAT：它提供什么能力
2. WHEN：当前任务是否命中具体触发场景
3. BOUNDARY：相邻 skill 是否更合适
4. PLATFORM：当前平台是否真正支持需要的工具或安装面

不要从 skill 名称猜完整能力，也不要把兼容语义、旧命令名或生成产物误当成平台原生功能。

选择规则

• 先确定用户当前目标、授权范围和完成条件，再选择 skill；用户明确要求优先于 skill 指导，仍须遵守平台权限和安全边界。
• 已授权的工作持续推进；能从当前证据解决的疑点先验证，不把 skill 的例行步骤变成新的确认门槛。
• 若 skill 确实导致暂停、请求批准或留下未完成工作，链接实际读取的 SKILL.md，引用具体条款并说明缺失的授权或决策；区分明确要求与自己的解释，同时继续不受阻的已授权工作。
• 只加载能改变当前动作的 skill。
• 两个 skill 顺序相关时，先用定义/诊断类，再用实现/验证类。
• 多个 skill 只是重复通用原则时，保留最具体的一个。
• 可从代码和配置推断的低风险事实直接验证；只有会改变路线的高风险歧义才询问用户。
• skill 缺失或平台能力不足时，说明降级，并保留同一输出与验证契约。

常见序列

Feature:
command:start
→ idea-refine（仅在需要方向发散时）
→ spec-driven-development
→ planning-and-task-breakdown
→ incremental-implementation
→ test-driven-development
→ code-review-and-quality
→ verification-before-completion

Bug:
debugging-and-error-recovery
→ test-driven-development
→ code-review-and-quality
→ verification-before-completion

Skill asset:
skill-authoring-and-evaluation
→ context-budget-audit
→ verification-before-completion

输出

开始工作前只需记录：

Skill route:
- Current phase:
- Selected:
- Why:
- Deferred:
- Platform fallback:

选择完成后立即进入目标 skill，不继续扩写路由说明。