ShaoHua
cf96c56bed
本次提交完成了多项清理与规范工作： 1. 移除默认管理员硬编码配置与云同步相关代码 2. 简化前端与MAUI端的配置，关闭静态资源托管以外的冗余功能 3. 清理.gitignore与协调目录，移除临时文件与冗余规则 4. 统一项目命名规范，修正包名与版本号 5. 重构后端数据模型，移除ABP审计字段与云同步相关逻辑 6. 简化WebView配置与系统栏样式，移除不必要的平台检测代码 7. 更新文档与规则文件，完善项目规范与版本记录
58 lines
3.4 KiB
Markdown
58 lines
3.4 KiB
Markdown
---
|
||
alwaysApply: false
|
||
---
|
||
# 研发工单拆分输出规范（必须遵守）
|
||
|
||
> 适用范围：本规则属于 **全局规则**（跨项目通用）。
|
||
|
||
> ⚠️ 术语澄清：本规范中的「研发工单（Dev Work Item）」专指智能体 / 开发者执行的**编码工作项**，与 Hua.Todo 项目业务领域中的「Todo 待办项」是两个完全不同的概念。
|
||
> 详见 [05-研发工单规则.md](./05-研发工单规则.md)。
|
||
> 凡涉及编码侧拆分时，**必须使用「研发工单」或「工单」**，禁止使用「任务」二字以避免与 Todo 待办项混淆。
|
||
|
||
## 适用时机
|
||
|
||
- 当需求需要先通读项目/产品/技术文档再开始实现时，必须先输出研发工单拆分文档，再开始写代码或改配置。
|
||
|
||
## 输出要求
|
||
|
||
- **先读完所有相关文档**：包括但不限于 `docs/`、`docs/project/` 下与本次需求相关的内容。
|
||
- **先写工单拆分，再动手实现**：研发工单拆分产出是后续执行的入口与对齐依据。
|
||
- **新增一个专属文件夹**：在 `docs/project` 下新建一个文件夹存放本次研发工单拆分文档。
|
||
- 文件夹命名建议：`研发工单-<主题>-<日期或版本>`（保持可检索、避免与既有文档冲突）。
|
||
- **可并行的工单要拆成不同 md**：能同步执行（相互无依赖/弱依赖）的工单，必须拆到不同的 Markdown 文件中，便于并行推进与分工。
|
||
- **文件必须带序号**：同一文件夹下的 md 文件按执行顺序编号，序号从小到大。
|
||
- 文件名建议：`01-xxx.md`、`02-xxx.md`、`03-xxx.md`。
|
||
- **每个研发工单文件至少包含**：
|
||
- 目标/范围（做什么、不做什么）
|
||
- 前置条件（依赖哪些结论/接口/文档）
|
||
- 验收标准（怎么判断完成，包含可执行的验证点）
|
||
- 风险与回滚（如有）
|
||
- **子工单完成后的标记要求**：
|
||
- 当任一子工单（例如 `01-*`/`02-*`/`03-*`）完成实现后，必须在对应版本的 `00-工单总览.md` 中同步标注"已完成"。
|
||
- 同时必须维护一张"待验证表"（可用 Markdown 表格），对每个子工单给出"待验证/已验证"状态，避免实现完成但验收未闭环。
|
||
- **并行冲突规避要求**：当工单会被分发到多个 solo 窗口并行推进时，每个研发工单文件必须额外包含：
|
||
- 触碰文件清单（Touch List，精确到文件）
|
||
- 共享文件策略（哪些是共享文件、唯一 Writer 是谁、如何与集成窗口对接）
|
||
- 编译绿线策略（如何确保阶段性交付不破坏编译）
|
||
|
||
## 推荐结构（模板）
|
||
|
||
- `00-工单总览.md`
|
||
- 背景与目标
|
||
- 关键决策与约束
|
||
- 并行分组说明（哪些文件可同步做）
|
||
- 待验证表（每个子工单的"待验证/已验证"状态）
|
||
- `01-<并行工单A>.md`
|
||
- `02-<并行工单B>.md`
|
||
- `03-<串行工单C>.md`
|
||
|
||
## 最小检查清单
|
||
|
||
1. [ ] 是否确认已阅读完所有相关文档？
|
||
2. [ ] 是否在 `docs/project` 下新建了本次专属文件夹（命名以"研发工单-"开头）？
|
||
3. [ ] 是否产出 `00-工单总览.md`（或等价总览文件）？
|
||
4. [ ] 是否将可并行工单拆分为不同 md 文件？
|
||
5. [ ] 是否所有 md 文件都带有连续序号？
|
||
6. [ ] 并行工单是否为每个研发工单文件补充了 Touch List/共享文件策略/编译绿线策略？
|
||
7. [ ] 子工单完成后，是否在对应版本的 `00-工单总览.md` 标注"已完成"，并在"待验证表"里更新状态？
|