功能契约 · 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)
- 读取根 Kit 的
references/atom-feature-contract.md与目标仓库规则、现有类型和测试。 - 用一句用户结果定义 atom;发现多个独立结果时拆分,不能用页面名代替业务边界。
- 列出规范化 input、output、错误、权限、副作用、幂等性、并发和版本策略。
- 为可预设参数生成
profiles.schema.json;秘密只允许 locator,不允许值。 - 记录至少一个来自真实请求的 golden vector,再补参数边界和预期失败。
- 在 manifest 中把不适用 surface 明确标为
not-applicable并写理由。 - 用目标语言的 schema/type validator 和根 helper 验证,修改契约后使旧 evidence 失效。
Output Contract
返回 manifest、contract schema、profile schema、acceptance vectors 的路径,以及仍未冻结的
业务决策。没有真实案例时保持 planned,不得制造向量或分数。
Dependencies
目标项目现有的类型、schema 与测试工具;无外部服务硬依赖。
