# 项目作业说明

> 本文件由组织者根据已脱敏的真实项目目标填写。所有 `[组织者填写]` 项在发放前必须完成。

## 项目背景

[组织者填写：真实但已脱敏的使用场景、当前问题和为什么值得解决。]

## 项目目标

[组织者填写：本次交付要产生的用户价值和可观察结果。]

## 用户故事

- 作为 `[用户角色]`，我希望 `[行为]`，从而 `[价值]`。

## 功能要求

### 必须完成

- [组织者填写]

### 可选增强

- [组织者填写；没有则写“无”。]

## 非功能要求

- 可运行性：[组织者填写]
- 可靠性与错误处理：[组织者填写]
- 性能或资源限制：[组织者填写]
- 安全、隐私与无障碍要求：[组织者填写]

## 范围与限制

### 范围内

- [组织者填写]

### 范围外

- [组织者填写]

### 技术与时间限制

- 周期：[组织者填写，通常为 1–2 周]
- 技术限制：[组织者填写；无强制栈时明确允许自行选择]
- 外部服务与数据：[组织者填写模拟方案，不提供个人凭证]

## 澄清机制

在“澄清 Issue”中提出问题，并写明：背景、歧义、候选方案、推荐方案和不回答时采用的可逆假设。会改变核心范围、引入费用、发送外部消息或处理敏感数据的问题，必须等待组织者确认。

## 交付物与证据

- 可运行代码和必要配置示例。
- `README.md`：安装、运行、验证和已知限制。
- `docs/PRD.md` 与 `docs/PLAN.md`。
- 自动化测试及 `docs/TEST_EVIDENCE.md` 中的命令、结果和证据索引。
- `docs/AI_COLLABORATION.md`：Codex 使用、本人判断与核验。
- `docs/RETROSPECTIVE.md`：最终复盘。
- 阶段 Issue、PR 和清晰提交历史。

## 可测试验收标准

| ID | Given / 前置条件 | When / 操作 | Then / 可观察结果 | 验证方式 |
|---|---|---|---|---|
| AC-01 | [组织者填写] | [组织者填写] | [组织者填写] | 自动测试 / 手工复现 / 其他 |

验收标准必须描述可观察结果，不能只写“体验良好”“代码优雅”等不可复现判断。

## 技术讲解与追问准备

学员需要准备说明架构、关键数据流、失败处理、测试策略、主要取舍、AI 输出如何核验，以及任一关键提交为何这样实现。验收可能包含现场追问和一项临时新增需求。

## 安全与合规

不得提交简历、联系方式、凭证、真实雇主代码、客户数据、商业秘密、个人 Codex 会话或其他未授权材料。不得共享或中转 Codex 账号或 API Key。本活动不承诺就业结果。