From 07251739d81ab2d324cc6c42414dcad5a73c68fb Mon Sep 17 00:00:00 2001 From: yumoqing Date: Wed, 16 Sep 2026 18:23:53 +0800 Subject: [PATCH] =?UTF-8?q?docs(skills):=20=E8=A7=92=E8=89=B2=E6=8A=80?= =?UTF-8?q?=E8=83=BD=E5=90=8C=E6=AD=A5=E8=A6=81=E6=B1=82=E7=BB=91=E5=AE=9A?= =?UTF-8?q?=E6=9C=BA=E5=88=B6=E2=80=94=E2=80=94analyst=E9=AA=A8=E6=9E=B6?= =?UTF-8?q?=E7=94=9F=E6=88=90=E5=90=8Echeck=5Frequirement=5Fbinding?= =?UTF-8?q?=E4=BD=93=E6=A3=80+=E8=AF=AD=E4=B9=89=E8=A3=81=E5=86=B3?= =?UTF-8?q?=E8=90=BD=E7=BB=91=E5=AE=9A+=E5=85=A8=E5=B1=80=E8=A7=84?= =?UTF-8?q?=E5=88=99=E6=9D=A1=E7=9B=AE=E6=94=B9req=5Ftype=3Dother;writer/b?= =?UTF-8?q?iz=5Fwriter=E6=8C=89=E7=BB=91=E5=AE=9A=E8=A6=81=E6=B1=82?= =?UTF-8?q?=E4=B8=BA=E6=AD=A3=E6=96=87=E5=94=AF=E4=B8=80=E5=9F=BA=E5=87=86?= =?UTF-8?q?,fallback=E5=B8=A6=E2=9A=A0=E5=85=88=E8=AF=AD=E4=B9=89=E6=A0=B8?= =?UTF-8?q?=E5=AF=B9;reviewer=E6=8C=89=E7=BB=91=E5=AE=9A=E8=A6=81=E6=B1=82?= =?UTF-8?q?=E8=AF=84=E5=AE=A1,=E6=8B=BF=E9=94=99=E8=A6=81=E6=B1=82?= =?UTF-8?q?=E8=AF=84=E9=94=99=E7=AB=A0;qc=E5=8A=A0check=5Frequirement=5Fbi?= =?UTF-8?q?nding=E5=B7=A5=E5=85=B7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../roles/agent.bid_biz_writer/role/SKILL.md | 6 +++++- .../roles/agent.bid_reviewer/role/SKILL.md | 6 +++++- .../roles/agent.bid_writer/role/SKILL.md | 7 ++++++- .../bidding_general/roles/agent.qc/role/SKILL.md | 2 +- .../roles/agent.tender_analyst/role/SKILL.md | 10 +++++++++- 5 files changed, 26 insertions(+), 5 deletions(-) diff --git a/skills_library/pipelines/bidding_general/roles/agent.bid_biz_writer/role/SKILL.md b/skills_library/pipelines/bidding_general/roles/agent.bid_biz_writer/role/SKILL.md index e1d0ab0..99de9aa 100644 --- a/skills_library/pipelines/bidding_general/roles/agent.bid_biz_writer/role/SKILL.md +++ b/skills_library/pipelines/bidding_general/roles/agent.bid_biz_writer/role/SKILL.md @@ -8,7 +8,11 @@ tools: [list_chapters, chapter_detail, write_chapter, submit_chapter, search_bid # 商务标撰写工程师（agent.bid_biz_writer）角色定义 ## 职责（只写 section=business 的章节） -- 任务带 chapter_id：chapter_detail 读章节要点与投标文件要求。 +- 任务带 chapter_id：chapter_detail 读章节要点与**本章编写要求（doc_requirements）**。 + 要求以显式绑定为准（binding=explicit）；binding=fallback_by_no 且带⚠警告时， + 必须先 list_doc_requirements 语义核对本章标题与要求标题是否同章（两套编号会漂移， + 同号≠同章），错位则不要照它写并在任务说明里报告；核对一致才作为编写依据。 + 格式文档正文 = 按绑定要求里 source_ref 指向的招标格式原文照录 + 填实值（见 bid-doc-spec）。 - 商务标要素清单（按招标文件要求逐项应答，缺一项 = 废标风险）： 投标函及附录、法定代表人身份证明/授权委托书、投标保证金凭证说明、 已标价工程量清单/报价表、资格审查资料（资质/财务/业绩/人员）、 diff --git a/skills_library/pipelines/bidding_general/roles/agent.bid_reviewer/role/SKILL.md b/skills_library/pipelines/bidding_general/roles/agent.bid_reviewer/role/SKILL.md index 6f51c87..d041fd2 100644 --- a/skills_library/pipelines/bidding_general/roles/agent.bid_reviewer/role/SKILL.md +++ b/skills_library/pipelines/bidding_general/roles/agent.bid_reviewer/role/SKILL.md @@ -8,7 +8,11 @@ tools: [list_chapters, chapter_detail, review_chapter, approve_chapter, reject_c # 标书评审员（agent.bid_reviewer）角色定义 ## 职责 -- 任务带 chapter_id：chapter_detail 读正文与对应评分项得分规则。 +- 任务带 chapter_id：chapter_detail 读正文、对应评分项得分规则与**本章编写要求 + （doc_requirements，显式绑定优先）**。评审"符合投标文件要求"维度必须按绑定要求判—— + binding=fallback_by_no 带⚠警告时先语义核对要求是否真属于本章（同号≠同章，两套编号会 + 漂移），拿错要求评错章节 = 整章按错标准放行/退回；发现错位应在 comments 里指出并请 + 分析角色 patch_chapters 落绑定，不得默认按编号要求打分。 - **纯技术方案流程**（任务 flow_key=bid_tech_proposal）：评审基准是技术需求书评估项覆盖度 （不是评分规则）——逐条核对章节是否响应 outline 声明的评估项、深度是否到操作层，详见 `bid-tech-proposal`。 - 按得分规则原文逐维度判定响应程度打分，review_chapter 落分。 diff --git a/skills_library/pipelines/bidding_general/roles/agent.bid_writer/role/SKILL.md b/skills_library/pipelines/bidding_general/roles/agent.bid_writer/role/SKILL.md index 89f3caa..c0155e7 100644 --- a/skills_library/pipelines/bidding_general/roles/agent.bid_writer/role/SKILL.md +++ b/skills_library/pipelines/bidding_general/roles/agent.bid_writer/role/SKILL.md @@ -8,7 +8,12 @@ tools: [list_chapters, chapter_detail, write_chapter, submit_chapter, search_bid # 技术标撰写工程师（agent.bid_writer）角色定义 ## 职责（写 section=technical/price 的章节） -- 任务带 chapter_id：chapter_detail 读章节要点、对应评分项及得分规则、上轮改进意见。 +- 任务带 chapter_id：chapter_detail 读章节要点、对应评分项及得分规则、上轮改进意见、 + **本章编写要求（doc_requirements）**。要求以显式绑定为准（binding=explicit）； + binding=fallback_by_no 时看 doc_requirements_warning：⚠可疑 = 编号匹配可能递错要求， + **必须先 list_doc_requirements 语义核对本章标题与要求标题是否同章**，错位则不要照它写， + 报告任务说明里请分析角色落绑定；核对一致才可作为编写依据。要求原文（含格式出处 + source_ref）是正文结构的唯一基准——照要求写，不凭通用习惯写。 - **纯技术方案流程**（任务 flow_key=bid_tech_proposal）：章节以技术需求书评估项为覆盖基准 （outline 已写清本章响应的评估项），写到操作层对标需求书原文，不按评分规则组织——详见 `bid-tech-proposal`。 - 按得分规则枚举的子维度组织小节，逐维度应答，写到操作层（量化指标/流程步骤/责任人/表单）。 diff --git a/skills_library/pipelines/bidding_general/roles/agent.qc/role/SKILL.md b/skills_library/pipelines/bidding_general/roles/agent.qc/role/SKILL.md index 4af7757..6427909 100644 --- a/skills_library/pipelines/bidding_general/roles/agent.qc/role/SKILL.md +++ b/skills_library/pipelines/bidding_general/roles/agent.qc/role/SKILL.md @@ -2,7 +2,7 @@ name: role description: 投标QC：解析产出契合度审核（评分项/资质/投标文件要求/章节骨架/成本收益五类对照招标文件原文按10分制打分，>8.5放行；纯技术方案流程审技术评估项对照需求书）。先 load_skill 加载 bid-qc 规范再审核。 capability: bid_qc_capability -tools: [start_qc, finish_qc, list_qc, qc_report, read_tender_file, list_tender_files, list_scoring_items, list_doc_requirements, list_qualifications, list_chapters, list_tech_items] +tools: [start_qc, finish_qc, list_qc, qc_report, read_tender_file, list_tender_files, list_scoring_items, list_doc_requirements, check_requirement_binding, list_qualifications, list_chapters, list_tech_items] --- # 投标质量控制（agent.qc）角色定义 diff --git a/skills_library/pipelines/bidding_general/roles/agent.tender_analyst/role/SKILL.md b/skills_library/pipelines/bidding_general/roles/agent.tender_analyst/role/SKILL.md index 001d2d8..187726a 100644 --- a/skills_library/pipelines/bidding_general/roles/agent.tender_analyst/role/SKILL.md +++ b/skills_library/pipelines/bidding_general/roles/agent.tender_analyst/role/SKILL.md @@ -2,7 +2,7 @@ name: role description: 招标文件分析师：按任务维度并行分析——评分项+得分规则/资质清单/投标文件要求+章节骨架/成本收益分析；纯技术方案流程解析技术需求书六类评估项。抽取漏项必须补。 capability: bid_analysis_capability -tools: [read_tender_file, list_tender_files, extract_scoring, extract_quals, extract_reqs_outline, extract_cost_benefit, add_scoring_item, add_qualification, add_doc_requirement, update_doc_requirement, add_cost_benefit_item, list_cost_benefit, update_cost_benefit_item, delete_cost_benefit_item, create_chapter_outline, patch_chapters, list_scoring_items, list_doc_requirements, list_qualifications, mark_file_extracted, extract_tech_items, add_tech_item, list_tech_items] +tools: [read_tender_file, list_tender_files, extract_scoring, extract_quals, extract_reqs_outline, extract_cost_benefit, add_scoring_item, add_qualification, add_doc_requirement, update_doc_requirement, add_cost_benefit_item, list_cost_benefit, update_cost_benefit_item, delete_cost_benefit_item, create_chapter_outline, patch_chapters, check_requirement_binding, list_scoring_items, list_doc_requirements, list_qualifications, mark_file_extracted, extract_tech_items, add_tech_item, list_tech_items] --- # 招标文件分析师（agent.tender_analyst）角色定义 @@ -20,6 +20,14 @@ tools: [read_tender_file, list_tender_files, extract_scoring, extract_quals, ext - `analysis_dim=scoring` → 用 **extract_scoring** 抽取评分项+得分规则（逐条覆盖评标办法，满分准确，否决项 is_veto=1）。大文件分段（offset 递增），重复项自动去重。 - `analysis_dim=quals` → 用 **extract_quals** 抽取资质清单与要求（原文要求+是否必需）。 - `analysis_dim=reqs_outline` → 用 **extract_reqs_outline** 抽取投标文件要求（章节结构/格式/密封/份数/截止）并自动生成章节骨架（structure 类要求自动生成，评分项能挂多少挂多少）。 +- **章节↔编写要求绑定对齐（2026-09-16 铁律，编号错位实测根因）**：抽取要求的 chapter_no + 按招标书目录编号、章节骨架按投标文件装订编号，**两套编号会漂移**（实测：要求 1.3=营业执照 + vs 章节 1.3=授权委托书）。骨架生成后必须调 **check_requirement_binding** 体检，对报告中 + 每条错位可疑项做语义裁决（读两边标题+requirement 原文判断是否同章），确属错位的用 + **patch_chapters(doc_requirements_by_no=[{chapter_no:要求条目号}])** 给章节落显式绑定 + （doc_requirement_ids）；全局规则类条目（如"总体构成与编制顺序""分公司投标口径"）不是 + 具体章节要求，用 update_doc_requirement 改 req_type=other，不得占 structure 号。 + 绑定没落对 = 写者拿错编写要求 = 整章按错标准写，QC/评审同一把错尺子发现不了。 **招标未明示技术标目录结构时**：按项目类型 load 参照模版裁剪骨架——AI智能体/大模型/软硬件一体类 → `bid-aiagent-tech-outline`（23章蓝本）；IT人力外包/人力资源服务类 → `bid-itstaffing-tech-outline`（25章蓝本）。用其 references/scoring-mapping.md 的裁剪流程按本项目评分项删并补，骨架要点写清每章挂载的评分项；招标明示了目录的以招标为准，模版只做子节参照。 - `analysis_dim=cost_benefit` → 用 **extract_cost_benefit** 做投标成本与收益分析（保证金/预算/人力/采购等成本项 + 收益项，每项写推理依据，估算标注口径与置信度）。 - `analysis_dim=tech`（**纯技术方案流程**，任务 flow_key=bid_tech_proposal）→ 输入是**技术需求书**（不是招标文件）：