技能工件
状态：已准入，正在构建中
技能服务操作注册表、生命周期语义以及非所有权边界 (C-COG-056..C-COG-058) 已在内核级别获得准入。跨应用消费者集成正在开发中。
什么是技能工件
认知中的技能工件是一个经过验证的建议包——一个命名的、有序的步骤序列，代理可以将其用作特定任务的剧本。技能是局部于认知范围内的；它们参与提示服务和摘要清理，但不拥有运行时执行。
技能是有意设计为建议性的，而不是可执行的。认知不会吸收运行时工作流执行。
操作注册表
权威层面：
| 关注点 | 权威 |
|---|---|
| 操作注册表 | tables/skill-service-operations.yaml |
| 操作规则 | C-COG-056 |
| 生命周期 + 检索规则 | C-COG-057 |
| 非所有权边界 | C-COG-058 |
每个被准入的技能服务操作必须：
- 在注册表中仅出现一次
- 声明被准入的输入、身份不变量、验证姿态、检索姿态、生命周期影响、派生视图行为、失败关闭原因、非所有权边界
技能能力的准入必须基于此注册表；不能从信封形状或包命名推断。
生命周期语义 (C-COG-057)
| 操作 | 约束 |
|---|---|
| 保存/更新 | 明确的在一个认知范围内一个包的语义 |
| 验证 | 经过验证的包必须要求非空的有序步骤；在重复步骤标识、重复顺序、非法引用、非法范围跨越时失败关闭 |
| 删除 | 技能所有权需要明确的删除语义 |
| 摘要触发的转换 | 保持归档/移除结果；不是隐藏的硬删除 |
| 列表/搜索 | 默认排除已移除的包 |
| 加载/历史 | 直到显式删除前，保留已移除的生命周期结果显式可见 |
| 历史暴露 | 创建、更新、归档、移除、删除的转换显式（客户端不应从当前包快照推断生命周期） |
非所有权边界 (C-COG-058)
本页上最重要的边界：
独立的认知技能与运行时执行编排保持分离。
| 技能不拥有 | 所有者 |
|---|---|
| 运行时调度真相 | 运行时 |
| 提供者/工具路由 | 运行时 |
| 自动化执行策略 | 运行时 |
| 控制平面状态 | 运行时 |
独立技能的生命周期和检索语义不授权认知吸收运行时执行策略或工作流的所有权。经过验证的技能工件可以参与提示服务和摘要清理；这种参与并不使认知成为运行时自动化所有者。
读者场景：代理保存一个技能
用户教他们的代理一个多步骤程序。代理将其捕获为一个技能包。
- 保存操作。 根据注册表调用技能服务的
Save操作。 - 验证。 包必须具有非空的有序步骤。步骤标识唯一。步骤顺序唯一。引用合法。不存在范围跨越。
- 持久化在认知范围内。 包存在于认知范围内（按代理 + 按上下文按被准入的范围）。
- 可用于提示服务。 技能通过被准入的提示通道作为建议性工件参与（参见 提示通道）。
- 不由认知执行。 当一个回合想要“遵循技能”时，运行时是执行权威——认知提供了剧本，运行时执行它。
读者场景：技能历史可见性
用户希望查看一段时间内技能包发生了什么变化。
- 历史查询。 技能服务公开生命周期转换：
创建 → 更新 → 归档 → 移除 → 删除。 - 每次转换都明确。 客户端可以看到包何时被归档、移除或删除；他们不会从“这是否当前在列表中？”推断生命周期。
- 移除但未删除。 一个被移除的包在历史记录中保持可见，直到显式删除；用户可以在那之前恢复它。
读者场景：认知尝试决定工作流
维护者提议让认知决定何时端到端运行一个技能。
- 拒绝。 根据
C-COG-058，技能所有权不包括运行时调度/提供者路由/执行策略。 - 重新路由。 运行时工作流（
workflow_*API）是执行表面；认知贡献技能包作为建议性输入。 - 边界保持。 认知仍然是认知权威；运行时仍然是执行权威。
读者场景：验证失败
调用者尝试保存一个有两个步骤具有相同步骤标识的包。
- 验证失败。 重复的步骤标识是失败关闭。
- 没有部分保存。 包不会在静默丢弃其中一个重复项的情况下被持久化。
- 调用者看到类型化的原因。 重复步骤标识的原因代码显示。
技能工件不做的事情
- 它们不由认知执行。
- 它们不拥有调度器/提供者路由/控制平面状态。
- 它们不会被静默降级以适应更宽松的生命周期。
- 它们不会通过“尽最大努力接受看起来合理的内容”进行验证——在标识/顺序/引用/范围违规时失败关闭。
- 它们不允许
list或search悄悄包含已移除的包。
边界总结
| 关注点 | 权威 |
|---|---|
| 操作注册表规则 | C-COG-056 + tables/skill-service-operations.yaml |
| 生命周期、检索、历史 | C-COG-057 |
| 非所有权边界 | C-COG-058 |
| 技能参与的家庭系统 | cognition/kernel/family-contract.md + tables/artifact-families.yaml |