Skip to content

lgy1027/specflow-agent-pack / skills/align

在实现前对齐跨角色、跨团队或跨系统的可观察行为;只在真实边界产生最小契约,优先沿用项目规范与测试。

FileKindSize
SKILL.mdskill md4.2 KB
references/contract-template.mdmarkdown2.3 KB

references/contract-template.md

View on GitHub
# Feature Contract — <功能名称>

> 状态:草稿 / 评审中 / 已评审待确认 / 已确认<br>
> 版本:`<项目约定的版本或修订号>`<br>
> 业务负责人:`<角色>`<br>
> 技术负责人:`<角色>`<br>
> 更新时间:`<时间>`<br>
> 确认记录:`<确认人及角色 / 确认范围与版本 / 日期;未确认时写待确认>`

状态按 `草稿 → 评审中 → 已评审待确认 → 已确认` 推进:负责人提交评审、评审意见处理完成、有权决策人记录签认。实质性修改范围、行为或验收口径时升版本并退回草稿/评审中,原确认不自动沿用。

“已确认”仅表示本契约范围内的责任人已完成确认,不代表生产发布、安全审批或其他范围授权。业务决策人确认用户行为和验收口径;技术负责人确认接口与实现边界。涉及数据、安全或设备风险时,记录相应责任人的确认。责任人或确认记录未知时,不得标记为已确认。

## 1. 用户问题与预期结果

- 用户和待完成任务:
- 当前工作流程与可观察痛点:
- 预期业务结果:
- 支撑证据和未验证假设:

## 2. 范围与排除项

- 本次包含:
- 明确不包含:
- 依赖系统、客户前置条件及负责人:

## 3. 数据、信任与副作用

- 输入分类及获准处理位置:
- 鉴权/授权负责人和执行边界:
- 模型输出校验、人审条件:
- 副作用、确认、幂等和审计要求:

## 4. 行为与接口约定

- 请求、事件或 CLI 调用:
- 响应、事件负载或产物:
- 有效状态和转移(仅在需要时):
- 错误、超时、取消、重试、部分成功:
- 兼容性和版本策略(沿用项目惯例):

## 5. 验收与验证

| 场景 | 输入/条件 | 预期行为 | 证据来源 | 自动或人工检查 |
|---|---|---|---|---|
| 成功 | | | | |
| 边界/歧义 | | | | |
| 失败/降级 | | | | |

说明校验器覆盖什么。Schema 合法不等于事实正确或生产安全。

## 6. 试点与生命周期决策(按需)

- 业务/质量/系统指标:
- 基线、样本门槛和观察窗口:
- 决策人与技术回滚负责人:
- 关闭、降级或回滚方式:
- 数据处置政策与批准人:

证据或决策缺失时标为 `Unknown`;不要预填统一阈值。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall