feat(skills): 文档配图硬规定——需求/设计文档四张图与一切SDLC交付文档、标书章节的图必须invoke_model t2i/i2i生成真图(2026-09-15用户要求);禁mermaid/plantuml/ASCII字符画;module-partitioning四张图产出形式改真图+diagrams-guide豁免语义;requirement/design角色+QC review-requirement/review-design核对项+bid-doc-spec/bid-review/bid_writer配图规范;逃逸阀=如实标注「配图缺失:平台无可用文生图模型」;agent_config会话agent提示词同步;机制层门禁在pipeline-service diagram_gate(bidding write/review_chapter复用)
This commit is contained in:
parent
770440a885
commit
10781e7a65
@ -481,7 +481,7 @@ DEFAULT_AGENT_CONFIG = AgentConfig(
|
||||
## 平台模型调用(生成图/视频/语音)
|
||||
平台配有多种能力模型(文生图/图生视频/语音合成等,范围=本机构+平台owner机构),通过 invoke_model 工具调用,list_platform_models 可查清单:
|
||||
- 用户要「画图/生成图片/做个视频/转语音」→ invoke_model(model 留空即按任务自动匹配最合适模型;task 写清画面/内容要求;媒体输入走 params 的 image_files/audio_files/video_files 数组)。
|
||||
- 产出文档/方案需要配图(架构图/效果图/封面)→ 同样用 invoke_model 生成真实图片,把返回的产物 URL 原样嵌入(markdown 图片语法)。**禁止用 ASCII 字符画拼示意图凑数**;平台无可用生成模型时如实说明,不伪造。
|
||||
- 产出文档/方案需要配图(架构图/效果图/封面)→ 同样用 invoke_model 生成真实图片,把返回的产物 URL 原样嵌入(markdown 图片语法)。**禁止用 ASCII 字符画拼示意图凑数**;需求/设计文档、技术方案/标书中的图(架构图/四张图/拓扑图/流程图)**必须**是 t2i/i2i 生成的真实图片,**禁止 mermaid/plantuml 代码块代替**(平台会硬门禁拦截)。平台无可用生成模型时如实说明,不伪造。
|
||||
- 对话/写作/分析类任务由你自己完成,不要用 invoke_model。
|
||||
|
||||
## 工具集
|
||||
|
||||
@ -37,6 +37,11 @@ related_skills: [function-point-counting, feature-granularity-and-testing, modul
|
||||
|
||||
### 第 2 步:画四张图(判边界的唯一客观依据,详见 references/diagrams-guide.md)
|
||||
|
||||
**产出形式(硬规定)**:四张图必须用 invoke_model 调 t2i/i2i 模型生成**真实图片**嵌入文档
|
||||
(``);禁止 mermaid/ASCII/文本框线图代替。先按 diagrams-guide 的文字模板整理
|
||||
对象/关系/状态/归属要点(= 边界信号分析底稿 + t2i 提示词素材),再逐张生成真图。
|
||||
平台无图像模型(invoke_model FAIL)时按文字模板产出并如实标注「配图缺失」,不伪造。
|
||||
|
||||
| 图 | 画什么 | 读出什么边界信号 |
|
||||
|---|---|---|
|
||||
| ① 业务对象图 | 核心业务对象 + 对象间关系(1:1/1:N/聚合/引用) | 强聚合(组合/父子)的对象**同模块**;仅引用(外键/ID)的对象**可分属不同模块** |
|
||||
@ -125,7 +130,7 @@ related_skills: [function-point-counting, feature-granularity-and-testing, modul
|
||||
## 输出模板(architecture.md 模块划分章节 + modules/{模块名}.md)
|
||||
|
||||
architecture.md 写:
|
||||
1. 四张图(业务对象/生命周期/数据所有权/业务依赖,文字或 mermaid)。
|
||||
1. 四张图(业务对象/生命周期/数据所有权/业务依赖)——**必须是 invoke_model t2i/i2i 生成的真实图片**(``),禁止 mermaid/ASCII/文本图代替(平台无图像模型时按文字模板产出并如实标注配图缺失)。
|
||||
2. 模块清单表:模块名 | 业务能力(A) | 唯一责任(F) | 核心对象 | 依赖模块 | 开发顺序 | 复用/新建。
|
||||
3. 复用判定:哪些能力复用已有模块、如何挂载。
|
||||
4. 模块依赖图 + 拓扑开发顺序。
|
||||
|
||||
@ -1,7 +1,15 @@
|
||||
# 四张图绘制指南(模块边界判定的客观依据)
|
||||
|
||||
四张图是模块划分的**证据层**:任何「这两个功能该不该同模块」的争议,回到图上找信号,
|
||||
不靠主观感觉。文字描述即可(必要时 mermaid),关键是**信号读法**。
|
||||
不靠主观感觉。关键是**信号读法**。
|
||||
|
||||
**产出形式硬规定(2026-09-15 用户要求)**:四张图必须用 invoke_model 调平台 **t2i(文生图)/
|
||||
i2i(图生图)模型生成真实图片**,以 `` 嵌入文档正文。
|
||||
**禁止 mermaid/plantuml/ASCII 字符画/文本框线图代替真图**。
|
||||
本指南各图的「文字模板」有两个用途:① 边界信号的分析底稿(写进正文作图的补充说明);
|
||||
② 生成 t2i task 提示词的素材(把对象/关系/状态/归属逐条写清,要求商务风、白底、含中文标注)。
|
||||
唯一逃逸阀:平台无任何图像生成模型(invoke_model 返回 FAIL)→ 按文字模板产出并在文档中
|
||||
如实标注「配图缺失:平台无可用文生图模型」,不伪造。
|
||||
|
||||
## ① 业务对象图
|
||||
|
||||
|
||||
@ -67,6 +67,14 @@ projects/{项目名}/docs/01-design/modules/{模块名}/
|
||||
|
||||
## 各角色产出内容(落点路径见 project-directory-spec)
|
||||
|
||||
### 配图统一硬规定(2026-09-15 用户要求,全角色适用)
|
||||
需求文档、设计文档(及一切 SDLC 交付文档)中出现的**各种图**——四张图(业务对象/生命周期/数据所有权/业务依赖)、系统架构图、模块依赖图、部署拓扑图、业务流程图、界面效果图等——**必须用 invoke_model 调平台 t2i(文生图)/i2i(图生图)模型生成真实图片**,以 `` 嵌入正文:
|
||||
- model 留空即自动选型;task 写清画面主体/层次/风格(商务风、白底、含中文标注)/图中文字要求;改造已有图带输入图 URL 走 i2i。
|
||||
- **禁止 mermaid/plantuml 代码块、ASCII 字符画、文本框线拼「示意图」代替真图**。
|
||||
- 文字版要点(对象关系清单/状态机描述/归属表格)可作为图的补充说明保留,但图本体必须是生成图片。
|
||||
- 唯一逃逸阀:平台无任何图像生成模型(invoke_model 返回 FAIL)→ 按文字模板产出并如实标注「配图缺失:平台无可用文生图模型」,不伪造、不因此阻塞交付。
|
||||
- QC/评审核对项:交付文档中的图若非真实生成图片(发现 mermaid/ASCII/文本图)= 不过,退回意见注明「图必须用 t2i/i2i 模型生成」。
|
||||
|
||||
### requirement(需求分析师)
|
||||
- **内容**: 项目概述、用户角色及权限、功能列表(含验收标准)、非功能需求、业务流程
|
||||
- **功能清单 + IFPUG 功能点计算**: 按 `function-point-counting` 技能产出 `docs/00-requirement/fp-report.md`(功能明细/汇总 UFP/待确认/假设 四件套,fp_calc.py 规则引擎计算,禁 LLM 心算)
|
||||
|
||||
@ -34,3 +34,14 @@ description: 投标文件编写规范——章节子项来自评分标准原文
|
||||
## 格式遵循
|
||||
- 章节号/标题/顺序严格按投标文件要求(bid_doc_requirements);
|
||||
- 页数限制、份数、密封要求写入合成说明,合成者按此执行。
|
||||
|
||||
## 配图硬规定(2026-09-15 用户要求,机制层 write_chapter 强制)
|
||||
- 技术方案/标书中需要的图(架构图/部署拓扑/组织图/流程示意/效果图等)**必须用
|
||||
invoke_model 调平台 t2i/i2i 模型生成真实图片**,产物 URL 独占一行以 ``
|
||||
嵌入正文(合成 docx 自动嵌真图)。model 留空自动选型;task 写清画面主体/层次/风格
|
||||
(商务风、白底、含中文标注)/图中文字;改造已有图带输入图 URL 走 i2i。
|
||||
- **禁止 mermaid/plantuml 代码块、ASCII 字符画、文本框线拼示意图**——write_chapter
|
||||
机制层会确定性检测并拒绝写入(返回 FAIL 与改法)。
|
||||
- 仅当 t2i、i2i 模型全无(invoke_model 返回 FAIL)时,正文照常写、该处不配图,
|
||||
并如实标注「配图缺失:平台无可用文生图模型」(此标注是机制豁免的唯一钥匙,禁滥用)。
|
||||
- 配图不计入篇幅凑数:正文字数仍须达最小门限。
|
||||
|
||||
@ -9,11 +9,15 @@ description: 评审与评分规范——章节评审按得分规则打分、整
|
||||
1. 读 chapter_detail(要点/对应评分项及得分规则/投标文件要求/正文)。
|
||||
2. **篇幅与完整性先查**:正文字数低于门限(技术 800/商务 500)或评分子维度漏应答 → 直接不通过,
|
||||
意见写明缺哪些维度/差多少字(机制层 review_chapter 也会强制退回,评审员主动把关)。
|
||||
3. 对照**得分规则原文**逐维度判断正文是否响应:有响应按规则给分,未响应/偏离按规则扣分。
|
||||
4. review_chapter 落分:不达标必须给可执行改进意见(缺哪个维度、补什么、对照哪条规则),
|
||||
3. **配图合规**(2026-09-15 硬规定):技术方案章节的图必须是 t2i/i2i 生成的真实图片
|
||||
(`` 嵌入);发现 mermaid/plantuml 代码块或 ASCII 字符画/文本框线「示意图」
|
||||
→ 不通过,意见注明「图必须用 invoke_model t2i/i2i 生成真图后重写」
|
||||
(机制层 review_chapter 会确定性兜底强制退回)。
|
||||
4. 对照**得分规则原文**逐维度判断正文是否响应:有响应按规则给分,未响应/偏离按规则扣分。
|
||||
5. review_chapter 落分:不达标必须给可执行改进意见(缺哪个维度、补什么、对照哪条规则),
|
||||
「退回但不说怎么改」会被工具拒绝。
|
||||
5. 评分禁止凭印象:分数必须能溯源到得分规则条款。
|
||||
6. 分角色核对:商务标章节查要素齐全(投标函/报价/资质证明/承诺/业绩),技术标章节查操作层深度。
|
||||
6. 评分禁止凭印象:分数必须能溯源到得分规则条款。
|
||||
7. 分角色核对:商务标章节查要素齐全(投标函/报价/资质证明/承诺/业绩),技术标章节查操作层深度。
|
||||
|
||||
## 整书评分(agent.bid_scorer,模拟评标专家)
|
||||
1. start_bid_score 取评审 ID + 评分项清单。
|
||||
|
||||
@ -25,7 +25,7 @@ tools: [list_chapters, chapter_detail, write_chapter, submit_chapter, search_bid
|
||||
- 用 invoke_model 调平台图像模型生成**真实图片**:model 留空即自动选型;task 写清画面主体、风格(如「简洁商务风架构图,白底,蓝色系,包含XX/YY/ZZ三层」)、图中文字要求。改造已有图时带输入图 URL(走 i2i);从零生成不带图。
|
||||
- 平台无专门 t2i 模型时自动兜底:选型会命中 i2i 模型,不带输入图 → 平台按 t2i 契约降级为文生图能力正常出图,不会被拦。
|
||||
- 成功后把产物 URL 原样嵌入章节正文,独占一行:``(合成 docx 时自动嵌入真图)。禁止改写/自编 URL。
|
||||
- **禁止 ASCII 字符画/文本框线拼示意图**。仅当 t2i、i2i 模型全无时 invoke_model 才返回 FAIL——此时不配图,正文照常写,不因此冒泡阻塞章节。
|
||||
- **禁止 ASCII 字符画/文本框线拼示意图,禁止 mermaid/plantuml 代码块**——write_chapter 机制层会确定性检测并拒绝写入(FAIL 带改法,改真图后重写)。仅当 t2i、i2i 模型全无时 invoke_model 才返回 FAIL——此时不配图,正文照常写并如实标注「配图缺失:平台无可用文生图模型」(豁免钥匙),不因此冒泡阻塞章节。
|
||||
- 配图不计入篇幅凑数:正文字数仍须达 bid_chapter_min_words 门限。
|
||||
|
||||
## 硬规则
|
||||
|
||||
@ -12,6 +12,10 @@ capability: task_capability
|
||||
- **先 load_skill 加载 `module-partitioning` 全文**,用它复核需求阶段的初步模块划分:
|
||||
- 读 `projects/{项目名}/docs/00-requirement/module-partition.md`(四张图+模块清单+复用判定)。
|
||||
- 八原则 A~I 逐条复核 + 四张图补全细化(需求阶段画不全的依赖边/所有权在设计期落定)。
|
||||
**图产出形式(硬规定)**:设计文档中的全部图(四张图/模块依赖图/系统架构图/部署拓扑图等)
|
||||
必须用 invoke_model 调平台 t2i/i2i 模型生成**真实图片**(`` 嵌入),
|
||||
禁止 mermaid/ASCII 字符画/文本框线图代替;改造已有图带输入图 URL 走 i2i,从零生成走 t2i。
|
||||
平台无图像模型(invoke_model 返回 FAIL)时按文字模板产出并如实标注「配图缺失」,不伪造。
|
||||
- **调整必须写明理由**(哪条原则/哪张图的哪个信号),禁止无证据推翻需求阶段划分;
|
||||
发现划分根本性错误(如环依赖、责任重叠)→ 修正并在 architecture.md 记录变更对照。
|
||||
- 细化产出:模块间依赖图(有向无环)+ 开发顺序拓扑序 + 每模块的接口契约草案
|
||||
|
||||
@ -36,6 +36,7 @@ capability: task_capability
|
||||
|
||||
6. **模块划分复核+细化**(对照技能映射表加载 `module-partitioning`):
|
||||
- **上游衔接**:design 的模块划分以 requirement 的 `docs/00-requirement/module-partition.md` 为上游。核对 architecture.md 有「复核结论」——沿用或调整;**每处调整必须写明依据**(八原则哪条/四张图哪个信号)。无证据推翻需求阶段划分 = 不过;完全没提 module-partition.md(凭空重划)= 不过。
|
||||
- **图必须是真实生成图片**:设计交付件(architecture.md/模块 design.md)中的四张图、模块依赖图、系统架构图、部署拓扑图等,必须以 markdown 图片语法 `` 嵌入平台生成的真实图片(invoke_model t2i/i2i)。出现 mermaid/plantuml 代码块、ASCII 字符画、文本框线拼的「示意图」= 不过(唯一豁免:如实标注「配图缺失:平台无可用文生图模型」且平台确无图像模型)。
|
||||
- 八原则抽查:模块清单逐条能对应业务能力(A)、唯一责任(F);无 1~2 表过细模块、无巨型模块;基础设施未当业务模块(G);标注复用的已有模块真实存在(铁律:能用已有模块必须用)。
|
||||
- 模块间依赖图无环 + 开发顺序拓扑可行(依赖在前)。
|
||||
7. **功能细化覆盖**:
|
||||
|
||||
@ -41,6 +41,7 @@ capability: task_capability
|
||||
- 需求含糊处已进待确认清单而非猜数(抽查有无「低置信度却给了数」)。
|
||||
6. **模块初步划分真实产出**:`docs/00-requirement/module-partition.md` 存在,且:
|
||||
- **四张图齐全**(业务对象/业务生命周期/数据所有权/业务依赖)——缺任一张 = 不过。
|
||||
- **图必须是真实生成图片**:四张图以 markdown 图片语法 `` 嵌入且 URL 为平台产物地址(invoke_model t2i/i2i 生成)。出现 mermaid/plantuml 代码块、ASCII 字符画、文本框线拼的「示意图」= 不过(唯一豁免:文档中如实标注「配图缺失:平台无可用文生图模型」——此时查平台确无图像模型才认)。
|
||||
- 模块清单表每模块写明业务能力(一句话动词+宾语)、唯一责任、核心对象、依赖、开发顺序、复用or新建。
|
||||
- **粒度铁律核对**:无「1~2 张表一个模块」(对照数据所有权图,一个模块只有 1~2 张表且职责说不满 = 过细,不过);无巨型模块(一个模块覆盖多个不相关业务对象 = 不过)。
|
||||
- **复用判定核对**:标注复用的已有模块真实存在(基础模块 apppublic/sqlor/ahserver/accounting/appbase/rbac 或平台已上线业务模块);能力已有模块覆盖却新建 = 不过。
|
||||
|
||||
@ -32,6 +32,10 @@ capability: feature_propose_capability
|
||||
不是业务模块,用平台基础模块(apppublic/sqlor/ahserver/appbase/rbac/accounting)。
|
||||
- 产出 `projects/{项目名}/docs/00-requirement/module-partition.md`:
|
||||
四张图 + 模块清单表(模块名/业务能力/唯一责任/核心对象/依赖/开发顺序/复用or新建)+ 复用判定 + 反模式自查表。
|
||||
- **四张图产出形式(硬规定)**:必须用 invoke_model 调平台 t2i/i2i 模型生成**真实图片**,
|
||||
以 `` 嵌入 module-partition.md;**禁止 mermaid/ASCII 字符画/文本框线图代替**。
|
||||
文字模板要点(对象/关系/状态机/归属表)作为图的补充说明与 t2i 提示词素材保留在正文。
|
||||
平台无图像模型(invoke_model 返回 FAIL)时按文字模板产出并如实标注「配图缺失:平台无可用文生图模型」,不伪造。
|
||||
- **这是初步划分**:design 阶段设计师会复核+细化+定 app(应用/部署单元划分仍归 design,
|
||||
requirement 不划分 app、不写 {应用名}_spec.json)。
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user