基于我方产品参考文档(白皮书、产品手册、测试报告、资质证书、方案文档等),对招投标技术指标要求做逐条符合性评估,产出带证据引用的中文 Markdown 评估报告。
不适用场景:
tech-doc-writer评估任务走下面这 6 步,按顺序执行。每步完成后简要汇报进度,关键节点等用户确认再继续。
开始前确认以下输入(能从用户消息里直接推断的就别问,一次性把不明的地方问完,不要多轮打扰):
/mnt/user-data/uploads/ 或用户指定的其它路径)/mnt/user-data/outputs/,文件名建议 <项目名>_指标评估报告.mdls 或 find 递归列出参考目录所有文档,把清单给用户看确认范围xxx-白皮书.pdf 多半讲整体能力、xxx-测试报告.pdf 多半有性能数据、xxx-功能清单.xlsx 是最容易直接匹配的),生成一份简短的"素材地图"/home/claude/)用临时 md 记录"哪个文档哪节讲了什么指标/功能点",作为后续逐条评估时的证据索引文件读取的核心原则(重要):检查 available_skills,如果环境里已安装 docx / xlsx / pptx / pdf-reading 等专门 skill,一律优先调用(view 对应 SKILL.md 并按其指引执行),不要自己写脚本重复造轮子。没有对应 skill 时,才用 Python 应急方案(python-docx / pandas / pdfplumber / python-pptx)。
扫描要点:对每份参考文档,重点提取以下信息存入素材索引:
把招标指标整理成一张结构化清单(先不评定,只规整),每条指标包含以下字段:
| 字段 | 说明 |
|---|---|
| --- | --- |
| 序号 | 原文档的序号或按顺序编号 |
| 类别 | 功能 / 性能 / 资质 / 服务 / 部署 / 安全 / 其它 |
| 指标描述 | 原文一字不改 |
| 要求级别 | 必须 / 应 / 宜(见 references/bid-terminology.md) |
| 重要标记 | ★ / ▲ / 无(见 references/bid-terminology.md) |
| 关键要点 | 从描述中提炼的可核验要点(可以拆成几个 bullet) |
复合指标必须拆分:一条指标里如果包含多个独立要求点(比如"支持 A 功能、B 功能和 C 功能,并发不低于 1000"),要在"关键要点"里拆成 4 条。评定时如果各要点满足情况不一致,整条按最弱的来。详见 references/evaluation-rules.md。
这一步务必让用户过一遍:把解析后的结构化清单简要列给用户(可以折叠展示前 10 条+总数),确认理解无偏差再进入评估。招标原文里如果有特殊表达("具有提供 xxx 证明材料的能力"这种含糊要求),在这一步就该标出来问清楚。
对清单中每一条指标,按以下顺序执行:
references/evaluation-rules.md 的标准判定references/evaluation-rules.md 的应答策略模板生成关键原则(底线,不可违反):
[文档名 > 章节/页码],找不到章节就给上下文关键词。边评边记:每评估一条,立刻把结果写入工作目录的临时 md 文件,而不是全部评完再写。防止上下文超限时丢失进度。
长清单分批:指标超过 30 条时,按每 15-20 条一批评估,每批完成后停下来汇报进度让用户审阅,再继续下一批。
按 references/report-template.md 的模板产出 /mnt/user-data/outputs/<项目名>_指标评估报告.md,结构如下:
写作风格:务实客观,不夸大也不悲观。招标应答文档里可能需要修辞包装,但评估报告的读者是内部决策者,准确比好看重要。
present_files 工具交付 .md 报告文件tech-doc-writer skill 用这份评估结果作为输入按需加载,不要一次性全读:
references/evaluation-rules.md —— 进入第 4 步前必读;四级评定详细规则、证据强度分级、应答策略模板、复合指标拆分示例references/report-template.md —— 进入第 5 步前必读;完整报告模板、评估表格规范、证据引用格式references/bid-terminology.md —— 第 3 步解析指标时参考;招投标术语(★▲、必须/应/宜、正负偏离、响应度等)的识别和处理共 1 个版本