技能

技能是专业工作包。

技能不只是工具。它可以包含说明、工作流、参考资料、模板、脚本、示例和质量标准。

技能目录结构

skills/
  travel-planning/
    SKILL.md
    references/
      itinerary-format.md
      visa-checklist.md
    templates/
      travel-plan.md
    scripts/
      budget_calculator.py

  course-design/
    SKILL.md
    references/
      bloom-taxonomy.md
      lesson-plan-format.md
    templates/
      course-outline.md

技能元数据

SKILL.md 应以 metadata 开始：

---
name: travel-planning
description: Use this skill to design practical travel plans, budgets, and risk checklists.
---

渐进式加载

kgent 不应把所有技能正文一次性加载进上下文。

默认上下文只应包含：

• skill name
• description
• tags
• basic capability summary

Agent 可以调用：

list_skills()
load_skill(name)

技能沉淀

一次运行结束后，kgent 可以生成候选技能：

runs/<run-id>/archive/candidate-skill/
  SKILL.md
  manifest.json
  references/
  templates/
  scripts/

候选技能不会自动激活。

提升应显式执行：

kgent skill promote runs/<run-id>/archive/candidate-skill ./skills/<skill-name>

治理

技能应支持：

• 激活前审查
• 版本管理
• 权限声明
• 依赖声明
• 示例
• 适用时的测试或校验