lov-atom-feature-contract v0.1.1A

Immutable. This exact content never changes and is served at /api/v1/blob/6c0e15742fb0ea0c.

---
name: lov-atom-feature-contract
description: >
  把一个用户任务冻结为可版本化的原子 Feature Contract、参数与 Profile Preset schema、错误和真实验收向量。触发：“定义这个 atom 的契约”或 “create an atom feature contract”。
license: MIT
compatibility: "Portable Agent Skills format. Uses the target repository's schema and test 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
    - contract
    - schema
    - acceptance
---

# 功能契约 · Feature Contract

把需求收敛成所有 SDK 与 adapter 共用的唯一业务契约。输出位于目标项目的
`.atom-feature/`，不替代目标语言自己的公开类型。

## Triggers

### Activate when

- “先把这个 atom 的输入、输出、错误和副作用定下来。”
- “为复杂参数设计 Profile Preset，并减少 Agent 后续追问。”
- “Create an atom feature contract and acceptance vectors.”

### Do not activate when

- 只写宽泛产品方案、单个 API 文档或 UI 表单；使用对应能力。

## Workflow (MANDATORY)

1. 读取根 Kit 的 `references/atom-feature-contract.md` 与目标仓库规则、现有类型和测试。
2. 用一句用户结果定义 atom；发现多个独立结果时拆分，不能用页面名代替业务边界。
3. 列出规范化 input、output、错误、权限、副作用、幂等性、并发和版本策略。
4. 为可预设参数生成 `profiles.schema.json`；秘密只允许 locator，不允许值。
5. 记录至少一个来自真实请求的 golden vector，再补参数边界和预期失败。
6. 在 manifest 中把不适用 surface 明确标为 `not-applicable` 并写理由。
7. 用目标语言的 schema/type validator 和根 helper 验证，修改契约后使旧 evidence 失效。

## Output Contract

返回 manifest、contract schema、profile schema、acceptance vectors 的路径，以及仍未冻结的
业务决策。没有真实案例时保持 `planned`，不得制造向量或分数。

## Dependencies

目标项目现有的类型、schema 与测试工具；无外部服务硬依赖。