Pārlūkot izejas kodu

docs: align module generation flow before HOME split

yanqiliang 2 mēneši atpakaļ
vecāks
revīzija
d227efd8f2

+ 1 - 1
01-项目文档_docs/01-旧项目分析/新版设计校准后最终功能模块清单.md

@@ -94,7 +94,7 @@
 
 ## 5. 可优先生成上下文包的模块
 
-基础框架可继续完成验收闭环。业务模块建议按以下顺序生成上下文包:
+`PRI-MP-BASE-001` 基础框架与应用壳层已完成开发、自检、项目管理复核和 OpenSpec archive,当前状态为 `已归档`。后续业务模块建议按以下顺序生成上下文包:
 
 1. `PRI-MP-HOME-001` 首页与医院配置。
 2. `PRI-MP-USER-001` 就诊人列表与选择组件。

+ 1 - 0
01-项目文档_docs/01-旧项目分析/旧版功能模块清单.md

@@ -13,6 +13,7 @@
 3. `PRI-MP-HOME-001` 正式名称为“首页与医院配置”。
 4. `PRI-MP-REG-001` 正式名称为“预约挂号基础流程”,不包含真实支付、医保支付、就诊人新增编辑、绑卡实名、OCR、人脸识别和挂号后记录状态。
 5. `PRI-MP-PAY-001` 正式名称为“微信支付基础、支付结果与异常查询”,医保能力独立为 `PRI-MP-PAY-002`。
+6. `PRI-MP-BASE-001` 当前状态以项目总控入口和功能模块总进度表为准,已完成开发、自检、项目管理复核和 OpenSpec archive,状态为 `已归档`。
 
 主要依据:
 

+ 3 - 0
02-AI协作_ai-workflow/02-Skill定义_skills/module-context-package-writing.md

@@ -81,6 +81,8 @@
 13. 禁止修改范围必须明确旧源码输入资料、新版设计输入资料、其他模块、管理流程文档和非本模块公共能力。
 14. 开发执行计划必须写明分支前置条件:若仓库不存在 `develop`,开发者 AI 应停止编码并报告阻塞。
 15. OpenSpec 与分支说明必须给出标准 change 路径:`openspec/changes/{openspec_change}/proposal.md`、`tasks.md`、`specs/{capability}/spec.md`。
+16. 必须写明开发者或开发者 AI 的允许写入范围:当前模块源码、当前模块上下文包、当前模块 OpenSpec change、`04-验收报告` 中的自检报告、`05-问题反馈` 中的自检问题反馈。
+17. 必须写明当前最新执行口径只以 `项目总控入口.md` 为准,不得新增平行最新入口或临时流程文件。
 
 ## 首批模块特别规则
 
@@ -105,3 +107,4 @@
 8. 是否避免把候选模块能力塞回正式模块。
 9. 是否写明 `develop` 缺失、OpenSpec 缺失、测试环境缺失等阻塞时的处理方式。
 10. 是否已用 `新版设计页面功能布局清单.md` 反向校准当前模块,明确新版已设计页面的采纳点、不采纳项和边界调整建议。
+11. 是否写明允许写入范围、固定输出目录和唯一最新执行口径入口。

+ 2 - 0
02-AI协作_ai-workflow/02-Skill定义_skills/module-spec-writing.md

@@ -36,6 +36,8 @@
 17. 未分配开发者前,模块状态不得直接转为 `待开发`。`PRI-MP-BASE-001` 已完成开发、自检、项目复核和 OpenSpec archive,当前状态为 `已归档`,可作为后续业务模块基础依赖。
 18. `PRI-MP-REG-001` 预约挂号基础流程必须明确排除真实支付、医保支付、就诊人新增编辑、绑卡实名、OCR、人脸识别和挂号后记录状态。
 19. 若输出文件夹形式的开发上下文包,必须同步遵循 `module-context-package-writing.md`。
+20. 必须写明开发者或开发者 AI 的允许写入范围:当前模块源码、当前模块上下文包、当前模块 OpenSpec change、`04-验收报告` 中的自检报告、`05-问题反馈` 中的自检问题反馈。
+21. 必须写明当前最新执行口径只以 `项目总控入口.md` 为准,不得新增平行最新入口或临时流程文件。
 
 ## 首批优先模块
 

+ 4 - 2
02-AI协作_ai-workflow/03-Prompt模板_prompts/生成功能模块文档.prompt.md

@@ -43,8 +43,10 @@
 17. 未分配开发者前,模块状态不得直接转为 `待开发`。`PRI-MP-BASE-001` 已完成开发、自检、项目复核和 OpenSpec archive,当前状态为 `已归档`,可作为后续业务模块基础依赖。
 18. 首批优先生成上下文包的模块为 `PRI-MP-HOME-001` 首页与医院配置、`PRI-MP-USER-001`、`PRI-MP-REG-001`、`PRI-MP-GUIDE-001`、`PRI-MP-ORDER-001`、`PRI-MP-MSG-001`、`PRI-MP-EYE-001`、`PRI-MP-EYE-002`。
 19. 如生成为 `PRI-MP-REG-001`,必须明确排除真实支付、医保支付、就诊人新增编辑、绑卡实名、OCR、人脸识别和挂号后记录状态。
-20. 若生成文件夹形式上下文包,必须完整输出 `README.md`、规格说明书、开发执行计划、页面清单、接口清单、UI 与交互要求、状态与异常矩阵、验收标准与自检清单、OpenSpec 与分支说明、禁止修改范围。
-21. 生成完成后,必须按 `module-context-package-writing.md` 的生成后自检清单输出一段“上下文包可交付性检查结论”。
+20. 必须写明开发者或开发者 AI 的允许写入区域:当前模块源码、当前模块上下文包、当前模块 OpenSpec change、`04-验收报告` 中的自检报告、`05-问题反馈` 中的自检问题反馈。
+21. 必须写明当前最新执行口径唯一入口为 `01-项目文档_docs/00-项目管理/项目总控入口.md`,不得新增平行“最新入口”或临时流程文件。
+22. 若生成文件夹形式上下文包,必须完整输出 `README.md`、规格说明书、开发执行计划、页面清单、接口清单、UI 与交互要求、状态与异常矩阵、验收标准与自检清单、OpenSpec 与分支说明、禁止修改范围。
+23. 生成完成后,必须按 `module-context-package-writing.md` 的生成后自检清单输出一段“上下文包可交付性检查结论”。
 
 
 

+ 14 - 0
02-AI协作_ai-workflow/04-文档模板_templates/功能模块开发上下文包模板.md

@@ -184,6 +184,19 @@ openspec/changes/{openspec_change}/specs/{capability}/spec.md
 4. 不修改项目管理流程文档。
 5. 不创建其他模块 OpenSpec change。
 6. 不改动全局请求、登录、支付等公共能力,除非当前模块文档明确要求。
+7. 不创建“最新入口”“最新口径索引”或临时流程文件;当前最新执行口径只以 `01-项目文档_docs/00-项目管理/项目总控入口.md` 为准。
+
+## 11.1 允许写入范围
+
+必须明确开发者或开发者 AI 只允许写入:
+
+1. 当前模块相关源码。
+2. 当前模块上下文包。
+3. 当前模块 OpenSpec change。
+4. `01-项目文档_docs/04-验收报告` 中的当前模块开发者自检验收报告。
+5. `01-项目文档_docs/05-问题反馈` 中的当前模块开发者自检问题反馈。
+
+如需修改项目管理入口、流程规范、其他模块文档、输入资料或归档产物,必须先停止并报告项目负责人确认。
 
 ## 12. 生成后自检
 
@@ -198,3 +211,4 @@ openspec/changes/{openspec_change}/specs/{capability}/spec.md
 7. 是否写明关键阻塞处理方式:缺少 `develop`、无法创建 OpenSpec、测试环境未确认、必须越界修改其他模块。
 8. 是否写明验收报告、问题反馈和归档总结固定输出目录,或引用项目级规则。
 9. 是否写明开发者 AI 不执行最终 OpenSpec archive 的边界。
+10. 是否写明允许写入范围和不得新增平行最新入口。

+ 5 - 0
02-AI协作_ai-workflow/04-文档模板_templates/功能模块规格说明书模板.md

@@ -220,6 +220,10 @@ OpenSpec change 至少包含:
 03-项目输入_project-inputs/02-新版设计_design
 ```
 
+开发者或开发者 AI 只允许写入当前模块相关源码、当前模块上下文包、当前模块 OpenSpec change、`01-项目文档_docs/04-验收报告` 中的当前模块开发者自检验收报告、`01-项目文档_docs/05-问题反馈` 中的当前模块开发者自检问题反馈。不得修改项目总控入口、项目管理流程规范、其他模块文档、其他模块 OpenSpec change、输入资料或最终 OpenSpec archive 产物。
+
+当前最新执行口径只以 `01-项目文档_docs/00-项目管理/项目总控入口.md` 为准,不得新增“最新入口”“最新口径索引”或临时流程文件。
+
 ### 14.5 开发步骤
 
 开发者应按以下步骤执行:
@@ -271,6 +275,7 @@ OpenSpec change 至少包含:
 - [ ] 验收标准可逐项勾选,并能映射到页面、接口、状态或业务规则。
 - [ ] OpenSpec change、base branch、feature branch 和 source_dir 已写明。
 - [ ] 禁止修改范围已写明旧源码输入资料、新版设计输入资料、其他模块和管理流程文档。
+- [ ] 允许写入范围已写明,且未新增平行最新入口或临时流程文件。
 
 ## 17. AI 验收记录