Skip to main content

​
Skill 对象

Skill 是 Huoban 的活字：一个可复用、可移动、可排列的原子能力。 Skill 不应该绑定具体项目上下文。项目差异由 Profile 注入，执行差异由 Run 和 Binding 决定。

​
语义

Skill 用于声明：
  • 它提供哪些 capabilities。
  • 接受哪些输入，产生哪些输出。
  • 需要哪些上下文或工具。
  • 可能产生哪些 declared side effects。
  • 是否天然需要 checkpoint。

​
spec 字段

字段要求说明
capabilities必填Skill 满足的能力命名空间，例如 huoban.dev/designReview。
inputs可选输入 schema 或输入引用。
outputs可选输出 schema 或 artifact 类型。
profileHints可选推荐注入的 Profile layer 类型。
sideEffects.declared必填可能产生的副作用声明。
checkpoint可选是否建议在执行前后触发校对。
adapterRef可选如果来自外部生态，指向对应 Adapter。

​
最小示例

apiVersion: huoban.dev/v1alpha1
kind: Skill
metadata:
  name: design-review
spec:
  capabilities:
    - huoban.dev/designReview
  inputs:
    - name: proposal
      type: markdown
  outputs:
    - name: review
      artifactType: decision-notes
  sideEffects:
    declared:
      - readFile
      - writeFile
  checkpoint:
    required: true
    reason: human-design-decision

​
status

Skill 通常是声明对象，不一定需要 status。由 registry 或 runtime 管理时，可以写入：
  • SkillIndexed
  • SkillValidated
  • TrustResolved
  • CapabilityMapped

​
设计约束

Skill 应尽量无状态。不要把项目规则、团队偏好、执行日志或一次运行的产物写进 Skill。