AI Agents 的 spec.md 模板

# spec.md

## Context
- 问题：
- 当前行为：
- 受影响用户或系统：

## Goal
- 最小有用结果：

## Scope
- 范围内：
- 允许写入路径：
- 只读上下文：

## Non-goals
- 明确排除：
- 不能变化的依赖或契约：

## Acceptance Criteria
- [ ] AC-1：
- [ ] AC-2：
- [ ] AC-3：

## Evidence
- 自动化测试：
- 手工检查：
- 日志、截图、指标或迁移输出：

## Open Questions
- 问题：
- 负责人：
- 是否阻塞实现：yes/no

如果这份 spec 和提示词冲突，以 spec 为准。

# spec.md

## Context
- 用户可以关闭所有通知，但安全告警必须保持强制开启。

## Goal
- 增加按渠道设置通知偏好，同时不允许关闭安全告警。

## Scope
- 范围内：settings UI、preferences API client、preference form tests
- 允许写入：src/settings/notifications/*, tests/settings/*
- 只读上下文：src/auth/*, src/api/preferences.ts

## Non-goals
- 不修改投递管线
- 不做 digest mode
- 不修改 auth role

## Acceptance Criteria
- [ ] Marketing email toggle 保存 marketingEmail=false。
- [ ] Security alert 行可见但锁定。
- [ ] 保存失败时还原之前状态并显示错误。

## Evidence
- npm test -- notifications
- 截图：锁定的 security alert 行
- PR 说明变更文件和跳过的检查