43b7abecea
- AGENTS.md 作为各代理共用的项目说明，CLAUDE.md 引用它 - 收录 PRD v0.9 原稿（只读） - .gitignore 排除样本原始文件与浏览器自动化产物 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
101 lines
8.6 KiB
Markdown
101 lines
8.6 KiB
Markdown
# AGENTS.md — 标博士（bid-doctor）
|
||
|
||
本文件是所有 AI 编码代理（Claude Code、Codex、Cursor 等）的共用项目说明。`CLAUDE.md` 只做引用，**请只改本文件**。
|
||
|
||
## 项目概况
|
||
|
||
- **产品名**：标博士（代码仓库名 `bid-doctor`）
|
||
- **一句话定位**：站在**投标方**一侧，贯穿「寻标 → 读标 → 写标 → 查标 → 投标」全生命周期的 AI 辅助工具。产品是「副驾驶」，不是「自动驾驶」。
|
||
- **当前阶段**：PRD v0.9 评审稿（2026-10-21），尚无代码。后续工作流依次为：需求分析 → 主题 / 品牌设计 → 原型设计 → UI 设计 → 技术架构 → 实现 → 测试。
|
||
- **需求来源**：当前有效版本是 `docs/招投标AI工具PRD-v0.9.1.html`（`docs/招投标AI工具PRD.html` 是 v0.9 原稿，保留作对照），再加上 `docs/decisions.md` 和 `docs/analysis/` 里已确认的 MVP 细化需求。三者冲突时：decisions.md > analysis > PRD。发现矛盾或缺失时，记录问题并向用户确认，不要自行假设。
|
||
- **工作语言**：文档、界面文案、提交说明默认使用简体中文；代码标识符、文件名使用英文。
|
||
|
||
## 产品结构速览
|
||
|
||
| 模块 | 内容 | MVP（P0） |
|
||
|---|---|---|
|
||
| M1 商机筛选 | 标讯聚合、订阅、AI 匹配打分、招标计划采集 | 否（P1/P2） |
|
||
| M2 招标文件解读 | 上传解析（PDF/Word/OCR）→ 资格 / 废标条款 / 评分点 / 关键日期结构化提取 → 原文回链 → 生成项目检查清单 | **是** |
|
||
| M3 废标风险检查（楔子） | 响应完整性、形式要件、资质匹配检查 → 人工逐项确认 → 检查报告 PDF 导出 | **是** |
|
||
| M4 标书生成 | 目录框架、分章初稿、知识库填充、偏离表、Word 导出 | 否（V1） |
|
||
| M5 查重雷同 | 自有历史查重、多份互查、雷同风险报告 | 否（V1/V2，合规边界条款为 P0） |
|
||
| M6 基础平台 | 项目工作台、额度计量与账单（P0）；协作权限、资产库（P1）；私有化（P2） | 部分 |
|
||
|
||
**MVP 范围** = M2 全部 P0 + M3 全部 P0 + M6 项目工作台 + 额度计量 + 免费版 / 专业版。需求分析阶段确认新增：多包 / 多标段、最小资质库、报价形式检查、补遗追加（简化版）、最小运营后台。完整清单见 `docs/analysis/03-functional-requirements.md`。
|
||
|
||
**首发行业是 IT 集成**（D1）。IT 集成项目多数走**政府采购体系**（《政府采购法》、财政部令第 87 号），少数走招标投标体系。两套体系的术语不一样（投标无效 / 否决投标）、无效情形也不一样，产品要先识别项目属于哪一套，再套用对应规则。详见 `docs/analysis/05-it-integration-domain.md`。
|
||
|
||
**核心数据设计**：M2、M3、M4、M5 共用同一份「**项目检查清单**」数据结构——解读阶段提取的要求项，在写标阶段是生成约束，在投前阶段是核对项。任何建模与架构设计都必须围绕它展开。
|
||
|
||
**项目状态流**：跟进中 → 编制中 → 已检查 → 已递交 → 已归档。
|
||
|
||
## 必须遵守的产品红线
|
||
|
||
这些约束贯穿设计、文案与实现，评审时逐条核对：
|
||
|
||
1. **辅助定位四件套**（PRD 4.1）：辅助生成（产出标注为初稿）、检查清单（逐项列出、含原文出处）、人工确认（关键节点须逐项确认）、全程留痕（谁在何时确认了什么，可审计）。
|
||
2. **可复核**：每条 AI 提取 / 检查结论必须可回溯到原文（页码 + 原句高亮）；无出处的结果只能进「待确认」区或降级为「提示」。
|
||
3. **禁用绝对化表述**：界面、协议、营销文案中禁止「保证不废标」「零废标」「100% 通过 / 准确」等说法；M3 只能称「辅助检查 / 风险提示」，报告首页须写明检查覆盖范围。
|
||
4. **不阻断用户**：「致命」项未处理完时项目状态保持「未就绪」，但不阻止导出——决定权在用户。
|
||
5. **不编造**：资质、业绩、知识库引用只能来自用户自有数据；缺失处用占位符提示补录。胜率等数据不足时宁可不展示。
|
||
6. **报价数字永不由系统生成或建议**，只提供结构与填充位。
|
||
7. **签章检查只做「位置与有无」提示**，不做真伪鉴定，界面明示。
|
||
8. **M5 只服务投前自查**：不得支持或宣传「帮多家投标人去雷同」等围串标规避用途。
|
||
9. **额度即货币**（PRD 4.3）：所有扣点规则可见、可查、可预警；解析失败 / 超时 / 系统异常不扣点；额度绑定账号与企业主体，不可转让。
|
||
10. **数据敏感**：传输与存储加密、按租户隔离、支持自助删除；SaaS 数据不用于训练公共模型。
|
||
|
||
### 政策引用的「双层口径」
|
||
|
||
先按项目所属的法律体系区分，再在体系内区分现行层和草案层（PRD v0.9.1 1.5）。政府采购项目的异常低价无效（87 号令第六十条）是**现行规定**，不能写成草案层，也不能挂「政策预警」标签。招标投标体系里引用政策时，严格区分两层，不得混同：
|
||
|
||
- **现行依据层**：发改法规〔2026〕195 号《关于加快招标投标领域人工智能推广应用的实施意见》——现行有效，但属政策指导文件而非法律。
|
||
- **草案强化层**：《招标投标法》修订草案——**尚在审议、未施行**，引用时必须标注。「政策预警」标签只用于草案层（如异常低价否决）。
|
||
- 195 号文「2026 年底全覆盖」只指招标文件检测、智能辅助评标、围串标识别三个场景；本产品的楔子场景对应 2027 年底全国推广，对外不得混写。
|
||
|
||
## 待决策事项（PRD 第 12 章）
|
||
|
||
开工涉及以下事项时先向用户确认，不要默认：
|
||
|
||
- ~~**D1 首发行业**~~：✅ 已定为 IT 集成（2026-11-02，见 `docs/decisions.md`）。IT 集成项目多数走政府采购体系，术语和规则见 `docs/analysis/05-it-integration-domain.md`。
|
||
- **D2 专业版额度数字**：解析 500 / 生成 300 为建议值，待成本实测定版。
|
||
- **D3 M1 商机数据来源**：自建抓取 vs 第三方接口（V2 前决策）。
|
||
- **D4 企业版首单策略**：是否提前准备私有化部署包。
|
||
|
||
需求分析阶段的待确认事项 G1–G10 已全部确认，见 `docs/decisions.md` A1。
|
||
|
||
## 技术约束（已定）
|
||
|
||
- **大模型**（T1）：只用国内云端的国产大模型，数据不出境。按场景路由：多模态（扫描件、签章）/ 快速 / 深度思考。业务代码只声明需要什么能力，不直接写死供应商和模型；每个 AI 任务都要记下模型和提示词版本。
|
||
- 其余技术栈尚未选定，由「技术架构设计」阶段决定并回填到本文件。
|
||
|
||
## 目录约定
|
||
|
||
```
|
||
docs/
|
||
招投标AI工具PRD.html # PRD v0.9 原稿（只读）
|
||
招投标AI工具PRD-v0.9.1.html # 当前有效版本；后续修订继续出新版本文件
|
||
analysis/ # 需求分析：用户旅程、用例、数据模型草案
|
||
design/ # 主题与品牌、设计规范（色彩、字体、组件 token）
|
||
prototype/ # 原型（低保真 / 高保真 HTML）
|
||
architecture/ # 技术架构、ADR（docs/architecture/adr/NNNN-*.md）
|
||
decisions.md # 产品与工程决策记录（含 D1–D4 的拍板结果）
|
||
samples/
|
||
tenders/ # 真实招标文件样本（README 是清单；原始文件不进 git，用 fetch.sh 获取）
|
||
```
|
||
|
||
以上目录按阶段推进时再创建，不要提前建空目录。代码目录结构在技术架构确定后补充到本文件。
|
||
|
||
## 工作方式
|
||
|
||
- 每个阶段产出落到 `docs/` 对应目录，并在本文件「当前进度」中更新一行。
|
||
- 用户确认的决策写入 `docs/decisions.md`（日期 + 决策 + 理由），不要只留在对话里。
|
||
- 设计与文案产出提交前，对照上方「产品红线」自查一遍。
|
||
- 技术栈确定后，在本文件补充：构建 / 运行 / 测试命令、代码规范、目录结构。
|
||
|
||
## 当前进度
|
||
|
||
- 2026-11-02：项目初始化，建立 AGENTS.md / CLAUDE.md。
|
||
- 2026-11-02：D1 定为 IT 集成；完成 MVP 需求分析（`docs/analysis/`）。
|
||
- 2026-11-02：G1–G10 全部按建议确认；出 PRD v0.9.1（补充政府采购体系）；大模型策略定为国产云端模型 + 按场景路由（T1）。
|
||
- 2026-11-02：从苏采云公开渠道收集了 10 份 IT 集成采购文件（`samples/tenders/`），分析结论见 `docs/analysis/07-sample-findings.md`。关键结论：实质性条款不能只认 ★（有的用斜体 + 下划线标注，解析时必须保留文字格式）；文件扩展名不可信；报价限价有三层。下一步：主题 / 原型设计。
|