yumoqing/pipeline_core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(skills): 目录规范更新——章节正本落库+机制镜像chapters/*.md(用户即时查看),media同目录,agent禁手改镜像

Browse Source
This commit is contained in:
yumoqing 2026-09-16 17:45:35 +08:00
parent 75fc4af332
commit 680c8bd39f
1 changed files with 7 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
skills_library/pipelines/bidding_general/common/project-directory-spec/SKILL.md
View File

@ -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 工具分段读） |