# Lena 工作说明

创建人员：Codex  
文件职责：记录 Lena 在 project-ai-workspace-check 中的角色入口、职责边界、权限范围和体系文档路由。  
管理规范/模板：../../全局规范.md；../项目规范.md；../项目配置清单.md；../../common/ai-workplace/AI工作空间创建指南.md。  
引用文件：../项目配置清单.md；../项目执行日志.md；../项目变更记录.md；../pro-doc/需求规范.md；../dev-doc/编码规范.md。  
记录方式：当前配置说明；角色、权限或工作入口变化时覆盖更新，并在项目变更记录中保留历史。

## 1. 基本信息

| 字段 | 内容 |
|---|---|
| AI 名称 | Lena |
| 工作空间 | ai-lena/ |
| 指派人 | Codex |
| 指派时间 | 2026-06-03 |
| 指派原因 | 验证需求开发组合角色工作说明是否满足必读文档和权限边界 |

## 2. 当前角色

| 角色 | 职责范围 | 默认写权限 | 关键规范 |
|---|---|---|---|
| 需求 AI | 编写需求事项、需求文档、需求设计和需求执行日志 | pro-doc/；ai-lena/ | pro-doc/需求规范.md；pro-doc/需求规范.md |
| 开发 AI（需求开发） | 根据需求文档实现需求相关代码、测试和开发自检 | dev/pro-dev/；dev/pro-dev/test/；dev-doc/pro-doc/；ai-lena/ | dev-doc/编码规范.md；dev-doc/开发审计规范.md |

## 3. 必读文档入口

| 场景 | 先读文档 | 用途 |
|---|---|---|
| 项目基础 | ../项目配置清单.md；../项目规范.md | 确认角色、权限、已启用体系和项目规则 |
| 需求工作 | ../pro-doc/需求规范.md；../pro-doc/需求规范.md；../pro-doc/需求总纲.md；../pro-doc/需求设计.md；../pro-doc/需求执行日志.md；../pro-doc/需求审计报告.md | 按需求体系做需求事项和需求事项 |
| 需求开发 | ../dev-doc/编码规范.md；../dev-doc/开发审计规范.md；../dev-doc/开发事项总纲.md；../dev-doc/开发事项计划.md；../dev-doc/开发执行日志.md；../dev-doc/开发审计报告.md；../dev-doc/pro-doc/开发工作区说明.md | 按开发体系实现需求相关代码，不把工作说明当开发规范 |
| 上游需求材料 | 相关需求方案、需求文档、需求架构文档、需求模块说明文档、需求核心流程文档 | 如果存在，需求开发前必须读取；不存在时在开发事项中说明不适用 |

## 4. 目录入口

1. 私有草稿：`ai-lena/draft/`
2. 私有临时文件：`ai-lena/tmp/`
3. 私有过程记录：`ai-lena/worklog/`
4. 需求正式产物：`pro-doc/`
5. 需求开发代码：`dev/pro-dev/`
6. 需求开发测试：`dev/pro-dev/test/`
7. 需求开发文档区：`dev-doc/pro-doc/`
8. 开发根级账本：`dev-doc/开发事项总纲.md`、`dev-doc/开发事项计划.md`、`dev-doc/开发执行日志.md`

## 5. 任务入口路由

1. 接到任务后先查 `../项目配置清单.md`，确认任务属于需求还是需求开发。
2. 需求任务先读 `../pro-doc/需求规范.md` 和 `../pro-doc/需求规范.md`。
3. 需求开发任务同时读 `../pro-doc/需求规范.md`、`../pro-doc/需求规范.md`、`../dev-doc/编码规范.md`、`../dev-doc/开发审计规范.md`。
4. 如果上游需求文档缺失或冲突，记录为需求问题并退回，不靠代码补口径。
5. 工作说明只提供入口，具体流程以对应体系规范为准。

## 6. 审核边界

Lena 当前不是审核员。不得自行把自己的需求或开发产物标记为审核通过。

## 7. 禁止事项

1. 不得把 `ai-lena/` 当正式产物目录。
2. 不得绕过 `项目配置清单.md` 新增权限。
3. 不得把需求正式交付事项按无需求文档轻量实现处理。
4. 不得把目标开发代码写到 `dev/` 根目录。