lov-atom-distribution-surfaces v0.1.1A

Immutable. This exact content never changes and is served at /api/v1/blob/80eb3b0d7a8be0e8.

---
name: lov-atom-distribution-surfaces
description: >
  从同一 Core SDK 与参数 schema 实现 CLI、REST API 和 Agent Skill adapter，并用相同测试向量验证等价结果。触发：“补齐功能分发形态”或 “build CLI API and Agent surfaces”。
license: MIT
compatibility: "Portable Agent Skills format. Adapts to the target project's CLI, HTTP and Agent runtime conventions."
depends_on:
  - lov-branding-consistency
metadata:
  author: LovStudio
  version: "0.1.1"
  card_standard: lovstudio/skill-card/v1
  content_class: deterministic-output
  tags:
    - atom-feature
    - cli
    - restful-api
    - agent-skill
    - adapters
---

# 功能多端分发 · Feature Distribution

把一个已验证的 SDK 适配为适用的 CLI、REST API 与 Agent Skill。adapter 负责输入翻译、
传输、权限和呈现，不复制业务规则。

## Triggers

### Activate when

- “基于共享 SDK 同时补 CLI、REST API 和 Agent Skill。”
- “检查这些 surface 是否真的行为一致。”
- “Build CLI, API and Agent surfaces for this atom.”

### Do not activate when

- 目标没有已批准的 contract 或可调用核心；先执行 feature-contract 与 core-sdk。

## Workflow (MANDATORY)

1. 从 manifest 选择真正适用的 surface，不为空形态造目录。
2. CLI 使用任务型命令、稳定 JSON envelope、明确退出码、`doctor` 与 `capabilities`。
3. REST API 使用版本化 request/response schema、OpenAPI、认证边界、幂等和结构化错误。
4. Agent Skill/tool schema 复用 contract 字段；先合并 Profile Preset，再只追问结果关键缺失值。
5. 所有 adapter 只调用公开 SDK，不复制校验、默认值或状态迁移。
6. 用同一 acceptance vector 分别调用至少两个 surface，规范化后比较业务结果和副作用。
7. 回读命令、OpenAPI 或工具注册状态；远端发布仍需独立授权与渠道证据。

## Output Contract

返回每个 surface 的入口、artifact、schema、示例、测试命令和验证层级；明确
`implemented`、`verified` 与 `released` 的区别。

## Dependencies

已批准的 Feature Contract 与可调用 Core SDK；其余依赖由目标项目决定。