diff --git a/skills_library/pipelines/bidding_general/common/project-directory-spec/SKILL.md b/skills_library/pipelines/bidding_general/common/project-directory-spec/SKILL.md index b0770a4..7c9cbe8 100644 --- a/skills_library/pipelines/bidding_general/common/project-directory-spec/SKILL.md +++ b/skills_library/pipelines/bidding_general/common/project-directory-spec/SKILL.md @@ -1,6 +1,6 @@ --- name: project-directory-spec -description: 投标产线（bidding_general）项目目录规范——工作空间布局、招标文件/合成产物落点、章节内容落库不落文件、禁止建 SDLC 式 docs/ 编号树。本产线所有角色产出/检查交付件前必读，完整覆盖 global 版。 +description: 投标产线（bidding_general）项目目录规范——工作空间布局、招标文件/合成产物落点、章节正本落库+机制镜像 chapters/ md 文件（用户即时查看）、禁止建 SDLC 式 docs/ 编号树。本产线所有角色产出/检查交付件前必读，完整覆盖 global 版。 --- # 项目目录规范（投标产线版 bidding_general） @@ -21,8 +21,12 @@ description: 投标产线（bidding_general）项目目录规范——工作空 ``` projects/{项目名}/ ├── {招标文件原名}.docx|pdf|md # 招标文件/技术需求书原件（import_tender_file 落盘） +├── chapters/ # 章节镜像（机制自动生成，用户查看用，2026-09-16） +│ ├── {order:03d}_{章节号}_{标题}.md # 每次 write_chapter/补料自动刷新；库(bid_chapters)才是正本 +│ └── media/ # 章节配图本地化副本（与文本同目录，md 里相对引用 media/xxx） ├── bid_v{N}.md # 合成产物：标书/技术方案书（compose 生成，N=版本号） ├── bid_v{N}.docx # 合成产物 docx（python-docx 可用时） +├── material_gaps_v{N}.md # 材料缺失清单（合成时自动出，人工补齐用） ├── proposal_outline_candidates.md # 模版候选骨架（template_confirm 阶段，可选） └── （配图等生成物由产线工具落盘，路径以工具返回为准） ``` @@ -30,7 +34,7 @@ projects/{项目名}/ ## 三、核心约定（与 SDLC 的根本差异，必读） 1. **不建 docs/ 编号子目录树**（00-requirement/01-design/…是开发产线特有结构）。投标项目没有分阶段文档目录，产出物直接落项目根。 -2. **章节内容落库不落文件**：章节骨架与正文存 `bid_chapters` 表（工具 create_chapter_outline/patch_chapters/write_chapter 写入），最终由 compose_bid 一次性合成 md+docx 到项目根。**禁止**把章节写成散落 md 文件充当交付（交付件与库不一致 = 落库核验必抓 = 任务作废）。 +2. **章节正本落库，机制自动镜像文件（2026-09-16 用户裁定）**：章节骨架与正文的正本存 `bid_chapters` 表（工具 create_chapter_outline/patch_chapters/write_chapter 写入），评审/合成/评分一律读库。write_chapter（replace/append）与 fill_material_gap 补料后**机制自动镜像**为 `chapters/{order:03d}_{章节号}_{标题}.md`（配图本地化进 chapters/media/ 同目录），供用户即时查看发现问题——镜像失败不阻塞写作。最终由 compose_bid 一次性合成 md+docx 到项目根。**agent 仍禁止手写/手改 chapters/ 镜像文件或散落 md 充当交付**（镜像由机制刷新，手改会被下次覆盖；交付件与库不一致 = 落库核验必抓 = 任务作废）。 3. **分析产出同样落库**：评分项 bid_scoring_items、资质 bid_qualifications、投标文件要求 bid_doc_requirements、成本收益 bid_cost_benefit、技术评估项 bid_tech_items（技术方案流程）。写 md 报告仅作交付说明补充，数据库修改必须经工具完成。 4. **合成产物由机制生成**：bid_v{N}.md/docx 只由 agent.bid_compositor 的 compose_bid 工具产出（全部章节 approved 后），其他角色不要手写「技术方案书.md」之类文件充当最终交付。 5. 用户上传的文件（招标文件/技术需求书/模板）经待办表单上传后落项目根，由 import_tender_file 登记进 bid_tender_files。 @@ -39,7 +43,7 @@ projects/{项目名}/ | 检查对象 | 位置 | |---------|------| -| 章节骨架/正文/状态 | `bid_chapters` 表（chapter_detail 工具），不是文件 | +| 章节骨架/正文/状态 | `bid_chapters` 表（chapter_detail 工具）正本；`chapters/*.md` 是机制镜像（用户查看/QC 参考可用，改动必须走工具回库） | | 分析产出 | 各产出表（QC start_qc 返回待核内容） | | 最终交付物 | 项目根 `bid_v{N}.md/docx` + `bid_documents` 表记录 | | 招标/需求原文 | `bid_tender_files.content_text`（read_tender_file 工具分段读） |