Skip to content
Back to search

technical-proposal-expert-writing-skill

Technical Proposal Expert 是一个专为政府和企业软件项目技术标书撰写而设计的 Claude Skill。该 Skill 将资深技术标书专家的经验与规范转化为可执行的 AI 助手能力,帮助用户撰写符合 GB/T 8567-2006 标准的正式技术文档。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yanhaoluo0--technical-proposal-expert-writing-skill/badge.svg)](/listings/yanhaoluo0--technical-proposal-expert-writing-skill)

HTML

<a href="/listings/yanhaoluo0--technical-proposal-expert-writing-skill"><img src="/api/listings/yanhaoluo0--technical-proposal-expert-writing-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

把整个仓库克隆到 skills 目录,**安装目录名统一为 `technical-proposal-expert`**:

# Cursor
git clone <本仓库 URL> ~/.cursor/skills/technical-proposal-expert

# Claude Code
git clone <本仓库 URL> ~/.claude/skills/technical-proposal-expert

每种工具只装一份。旧的 `software-engineering-docs` 名称已废弃,请删除旧副本,避免列表中出现「两个 skill」。

未自动加载时,在对话里说:`使用 technical-proposal-expert 写【文档类型】`。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 178 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: technical-proposal-expert
  3. description: MUST be used when writing, drafting, or polishing Chinese formal documents. Use when the user asks for 技术标书, 投标, 招标, 技术方案, 投标书, 方案设计报告, 系统设计说明, 测试报告, 测试总结, 工作周报, 周总结, or unspecified 公文/方案/文档. Also use when the document type is unclear and a writing scene must be chosen first.
  4. ---
  5. # technical-proposal-expert
  6. 把本 skill 当作强制指令集。写中文正式文档时,先完成本文件流程,再动笔。
  7. **违反条文等于违反精神。** 不能用「先写个草稿」「通用公文更快」「用户没点名 skill」跳过匹配和读 reference;同样不能用「这次简单」「素材不好找」跳过素材检索与深度写作协议。
  8. ## 铁律
  9. 1. **先匹配场景,再写。** 未锁定场景、未读取对应 reference 之前,禁止输出正文。
  10. 2. **场景 reference 优先于通用知识。** 标书的零分点、设计报告的章节骨架,以 reference 为准。
  11. 3. **通用书写要求与场景指引同时生效。** 禁词表、去列表化、分段确认、素材检索对所有场景有效。
  12. 4. **缺信息先问或写「待确认」,禁止编造** 指标、业绩、测试数据、招标条款编号。
  13. 5. **素材检索与知识库必做。** 涉及技术实现时,先跑索引脚本并按需检索,禁止凭印象写泛泛而谈。
  14. ## 工作流
  15. 复制并跟踪:
  16. ```
  17. - [ ] 1. 确定文档类型(未明确则询问,已明确则直接匹配)
  18. - [ ] 2. 匹配唯一场景;冲突则问 1 句;都不中则 general
  19. - [ ] 3. 确认文档使用场景(给谁看、什么场合)和撰写身份
  20. - [ ] 4. 读取对应 references/*.md(整份)
  21. - [ ] 5. 素材检索:检查索引 → 缺失则运行索引脚本(脚本在本 skill 的 `scripts/` 下,无参数;当前目录不是 skill 根目录时用完整路径)→ 按技术点/指标关键词检索命中行区间
  22. - [ ] 6. 按该 reference 撰写;遵守通用书写要求与深度写作协议
  23. - [ ] 7. 当前小节写完后自检禁词与列表;长文按约 1000 字暂停
  24. - [ ] 8. 交付前跑复核清单(见「交付前复核」)
  25. ```
  26. 行业用语为可选项:用户明确需要时,再生成临时词表(如 `writing-glossary-temp.txt`),只在上下文合适时自然带入,禁止堆砌。
  27. ## 素材检索与知识库
  28. 两份内容来源:
  29. - **knowledge/**:内置默认知识文档(技术卡片)。**按需检索**:写作每个功能点/技术点前,提取技术点与指标关键词 → 在 `knowledge/.index.json` 中匹配 chunk(先看 preview)→ 用 start/end 行区间读取源文件命中部分,只读命中内容
  30. - **素材库/**:**写作工作目录下**的用户素材(仅 md/txt),**不设全局素材库**。把招标文件摘编、技术规范、历史标书等放入当前写作目录的 `素材库/`;**命中相关即全文读取**(用户素材通常体量小且直接相关)。项目写完素材随项目保留或清理,不跨项目混用
  31. 流程:
  32. 1. 若 `knowledge/.index.json` 或 `素材库/.index.json` 不存在,或素材有新增/变更,先运行索引脚本(无参数,自动生成两个索引):`python scripts/index_materials.py`。脚本位于本 skill 的 `scripts/` 目录;当前工作目录不是 skill 根目录时,用该脚本的完整路径运行(仍无参数)。脚本只索引「skill 的 `knowledge/`」与「当前工作目录的 `素材库/`」
  33. 2. 读取两份索引,确认素材清单与结构
  34. 3. 写作前按技术点/指标关键词检索 knowledge 索引;用户素材全部读取
  35. 4. 把「素材使用清单」记入 plan.md 或草稿:功能点 → 使用了哪份素材的哪一节(保留来源以便核验)
  36. 5. 规则:项目素材与内置知识冲突时以项目素材为准;索引只指向行区间,检索后必须回到源文件读原文,禁止凭索引编造内容;交付正文不出现「参考了某文档」痕迹(除非用户要求)
  37. ## 技术路由(knowledge/)
  38. | 技术点关键词 | 默认知识目录 |
  39. |---|---|
  40. | 微服务、中台、服务治理 | knowledge/微服务与中台 |
  41. | 大数据、离线/实时计算 | knowledge/大数据 |
  42. | 视频AI、图像识别、算法 | knowledge/AI与视频分析 |
  43. | 物联网、传感器、边缘计算 | knowledge/物联网与感知 |
  44. | 信创、国产化、自主可控 | knowledge/信创与国产化 |
  45. | 等保、安全、密码、数据安全 | knowledge/安全与等保 |
  46. | 高可用、容灾、备份、集群 | knowledge/高可用与容灾 |
  47. | 数据治理、数据交换、共享 | knowledge/数据治理与交换共享 |
  48. | 低代码、BPM、流程引擎 | knowledge/低代码与BPM |
  49. | 移动端、小程序、App | knowledge/移动端 |
  50. | 云原生、K8s、容器、Redis、Kafka、Istio | knowledge/云原生与开源组件 |
  51. | 测试方案、测试金字塔、质量模型 | knowledge/测试与质量 |
  52. | 文档模板、SRS、SDD、DBDD、GJB 438C | knowledge/文档模板 |
  53. | 标准引用、合规核对 | knowledge/合规与标准 |
  54. 未命中则跳过,不强行套用。目录内文件按「技术卡片」格式组织,见 [knowledge/README.md](knowledge/README.md)。
  55. ## 深度写作协议(技术点必答六问)
  56. 每个关键技术点(选型、算法、架构决策)写作前强制回答,正文据此展开:
  57. 1. **解决什么问题**:对应哪个需求/指标/招标条款
  58. 2. **为什么这么选**:备选方案与取舍(禁止用「业界主流」「成熟稳定」搪塞)
  59. 3. **关键机制与数据流**:组件、协议、时序、核心算法
  60. 4. **工程化落地**:配置、部署、监控、灰度、回滚等可执行细节
  61. 5. **如何验证**:指标、测试方法、验收方式
  62. 6. **风险与降级**:失败模式、边界与应对
  63. 写完后自查:若一段话去掉修饰词后没有实质技术内容(组件、机制、数据流、数字),即为泛泛而谈,重写。
  64. ## 场景路由
  65. | 用户说法 | 场景 | 必须读取 |
  66. |---|---|---|
  67. | 技术标书、投标、招标、投标书、标书 | technical-proposal | [references/technical-proposal.md](references/technical-proposal.md) |
  68. | 方案设计报告、设计报告、系统设计、研制方案 | design-report | [references/design-report.md](references/design-report.md) |
  69. | 测试报告、测试总结、测试说明 | test-report | [references/test-report.md](references/test-report.md) |
  70. | 周报、周总结、工作周报、周度汇报 | weekly-report | [references/weekly-report.md](references/weekly-report.md) |
  71. | 其他、未明确、通用、一般文档 | general | [references/general.md](references/general.md) |
  72. **歧义**:只说「技术方案」、未提投标/设计时,问一句是「投标技术标」还是「方案设计报告」,不要两套一起写。
  73. 同一对话锁定场景后不要中途更换,除非用户明确要求切换。
  74. 未说明类型时,用下面这段询问(不要先写正文):
  75. > 已加载 technical-proposal-expert。支持:技术标书、方案设计报告、测试报告、周报;其他按常规文档处理。本次要写哪类文档?
  76. ## 撰写前必确认
  77. - **使用场景**:给谁看、什么场合(对外投标、内部汇报、甲方验收、留档等)
  78. - **身份**:撰写者或代表方(乙方技术负责人、项目经理、测试负责人等)
  79. 据此调整语气、详略与称谓。用户没给就简短追问,不要默认成空泛「我司」。
  80. ## 通用文本书写要求
  81. ### 禁词
  82. | 禁止 | 改为 |
  83. |---|---|
  84. | 总的来说 / 总之 | 综上所述 / 基于上述… / 鉴于此 |
  85. | 首先/其次/最后 | 第一,…;在此基础上,…;最终,… |
  86. | 我们致力于 | 本方案旨在 / 项目组将重点投入 |
  87. | 这是一个… | 该模块被定义为… / 该子系统主要承担… |
  88. | 可以/能够 | 具备…能力 / 实现…功能 / 支持…操作 |
  89. 「可以/能够」指技术能力时改写;若表示允许性或条件成立(如「在X前提下可以…」)则保留,不机械替换。
  90. ### 去列表化
  91. 正文避免纯分点。优先叙述或「总—分—总」。表格、接口、参数、库表、清单可用列表或表。场景若规定「零分点」(标书),以该场景为准。
  92. ### 逻辑
  93. 段落用「基于上述分析」「在…前提下」「针对…场景」衔接。层级是否强制(`一、` / `1.1`)看场景 reference。
  94. ### 输出
  95. - 每次输出完整小节或模块,不写半截;若小节自然结束时不足约 1000 字,先交付完整小节,不强行灌水
  96. - 长文档约每 1000 个中文字符暂停,等用户确认再继续
  97. - 写入文件时增量追加,不一次写完全文
  98. ## 交付前复核(每次交付前必做)
  99. 1. **待确认清零**:所有「待确认/待确认条款」从交付正文收敛为一份问题清单(单独文件或 plan.md 附录),正文清零后再交付;交付时附问题清单
  100. 2. **禁词扫描**:全文检查禁词表
  101. 3. **需求/条款响应核对**:标书逐条核对招标需求,设计报告核对需求与指标
  102. 4. **指标一致性**:指标数值与支撑设计一一对应,不允许「写了指标没写实现」或「写了实现没写指标」
  103. 5. **素材来源核验**:正文关键事实能在素材使用清单中找到来源;无来源内容已标「待确认」
  104. 6. **完整性**:章节骨架无缺漏(设计报告不合并删章)
  105. ## 找借口对照
  106. | 借口 | 事实 |
  107. |---|---|
  108. | 用户只要一段正文 | 仍要先匹配场景并读 reference |
  109. | 先按通用 SRS/方案写 | 场景骨架在 reference 里 |
  110. | 禁词太严、先写后改 | 按禁词表直接写 |
  111. | 标书用 bullet 更清晰 | 标书零分点;表结构除外;招标文件明确要求分点响应时例外 |
  112. | 没说身份也能写 | 未提供则追问,不编造甲方/乙方口吻 |
  113. | 这次简单,不用检索素材 | 素材检索是铁律;先看索引,命中才读,不增加负担 |
  114. | 检索太麻烦,凭经验写 | 泛泛而谈的根源就是跳过检索;索引有 preview,能快速定位 |
  115. ## 红旗 — 停下重来
  116. - 还没读对应 reference 就开始写
  117. - 标书正文出现 `-` / `*` 分点(招标文件明确要求除外)
  118. - 编造招标条款号、通过率、性能指标
  119. - 没跑索引脚本就写技术实现,或技术点只有概念词没有机制与数据流
  120. - 正文残留「待确认」就交付
  121. - 长文一次倒出数千字且不暂停
  122. ## 最小示例
  123. 用户:「写一份政务监管平台的技术标书,模块有一张图和告警。」
  124. 1. 路由 → technical-proposal → 读 `references/technical-proposal.md`
  125. 2. 确认场合=对外投标、身份=乙方技术负责人(若未说则问)
  126. 3. 跑索引脚本(若索引缺失;脚本在 skill 的 `scripts/` 下,无参数)→ 读两份索引;若工作目录有 `素材库/` 则用户素材全文读取;涉及视频/图像技术点检索 knowledge 对应卡片
  127. 4. 默认大文本模式:建 `plan.md`,先收架构与需求清单,再按模块叙述撰写
  128. 5. 每个功能点按六问协议展开(机制、数据流、指标支撑),正文零分点,并响应招标条款
  129. 6. 交付前跑复核清单(待确认清零等)
README.md · README · 139 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # technical-proposal-expert
  2. 中文正式文档写作 skill:**技术标书、方案设计报告、测试报告、周报**;其余文档走常规兜底。根目录 `SKILL.md` 是唯一入口,skill 内部把它当作强制指令集执行。
  3. ## 为什么有它
  4. 写技术标书和设计报告时,最常见的质量问题是「泛泛而谈」:实现方案只有概念词(微服务、高可用、大数据),没有选型理由、机制细节、指标支撑。本 skill 用三件事解决这个问题:
  5. 1. **内置知识库**(`knowledge/`):按技术域组织的「技术卡片」,写作时按技术点/指标关键词**选择性检索**,只读取命中章节,节省上下文
  6. 2. **项目素材库**(写作目录下的 `素材库/`):把招标文件摘编、技术规范、历史标书等放进项目目录,写作时**全文读取**,让内容贴合本项目实事;不设全局素材库,项目写完素材随项目保留或清理
  7. 3. **深度写作六问**:每个关键技术点必须回答「解决什么问题 / 为什么这么选 / 关键机制与数据流 / 工程化落地 / 如何验证 / 风险与降级」,禁止用修饰词堆砌替代实质内容
  8. 再加上零分点(标书正文禁止分点)、禁词表、「待确认」不编造、交付前复核清单等约束,保证输出有格式、有深度、可核验。
  9. ## 安装
  10. 把整个仓库克隆到 skills 目录,**安装目录名统一为 `technical-proposal-expert`**:
  11. ```bash
  12. # Cursor
  13. git clone <本仓库 URL> ~/.cursor/skills/technical-proposal-expert
  14. # Claude Code
  15. git clone <本仓库 URL> ~/.claude/skills/technical-proposal-expert
  16. ```
  17. 每种工具只装一份。旧的 `software-engineering-docs` 名称已废弃,请删除旧副本,避免列表中出现「两个 skill」。
  18. 未自动加载时,在对话里说:`使用 technical-proposal-expert 写【文档类型】`。
  19. ## 使用流程
  20. ```text
  21. 1. 说出文档类型 → skill 匹配唯一场景(标书/设计报告/测试报告/周报/兜底)
  22. 2. 确认场合与身份(给谁看、谁写),读取对应 references/*.md
  23. 3.(可选)在写作项目目录放素材到 素材库/
  24. 4. 运行索引脚本(无参数),生成两个 .index.json
  25. 5. 写作:按技术点/指标检索 knowledge,用户素材全文读取,按六问展开
  26. 6. 交付前复核:待确认清零、禁词扫描、条款响应、指标一致性
  27. ```
  28. 直接说要写的文档即可,例如「写技术标书」「出方案设计报告」「写测试报告」「写周报」。类型不明时会先问场景,再读对应 `references/`。
  29. ## 素材检索(核心用法)
  30. 两份内容来源,规则不同:
  31. | 来源 | 位置 | 加载方式 | 用途 |
  32. |---|---|---|---|
  33. | 内置知识库 `knowledge/` | skill 仓库内 | 按技术点/指标关键词**选择性读取命中行区间** | 通用技术深度 |
  34. | 用户素材 `素材库/` | **写作项目的工作目录**下 | **命中相关即全文读取** | 本项目实事 |
  35. 使用步骤:
  36. 1. 在**写作项目的工作目录**下创建 `素材库/`(本仓库的 `素材库/` 只是模板与说明),放入希望参考的素材(**仅 `.md` / `.txt`**,可建子目录)。建议放:招标文件摘编、技术规范、历史标书、架构说明、通用技术文档。
  37. 2. 生成索引(**无需任何参数**,自动扫描 skill 的 `knowledge/` 与「当前工作目录的 `素材库/`」):
  38. ```bash
  39. # 在写作项目目录下,用 skill 脚本的完整路径运行(无参数)
  40. python <skill目录>/scripts/index_materials.py
  41. ```
  42. 3. 之后写作时,skill 自动按技术点/指标关键词检索:内置知识读取命中章节,用户素材全文读取。素材有新增/变更时,重新运行一次脚本即可。
  43. 规则:
  44. - 项目素材与内置知识冲突时**以项目素材为准**;内置知识用于补足深度
  45. - 索引只是目录(文件清单 + chunk 行区间 + preview),检索后必须**回到源文件读原文**,禁止凭索引编造内容
  46. - 交付正文不出现「参考了某文档」痕迹(除非用户要求),但草稿/plan 中保留「素材使用清单」以便核验
  47. - 素材可能含敏感信息,`.index.json` 已 gitignore,素材文件默认不要提交到公开仓库
  48. ## 目录结构
  49. ```text
  50. SKILL.md # 唯一入口:铁律、工作流、素材检索、六问、交付复核
  51. references/ # 场景规范(标书/设计报告/测试报告/周报/兜底)
  52. knowledge/ # 内置知识库(46 份技术卡片与文档模板,按领域分目录,按需检索)
  53. 00-来源登记.md # 全部卡片/模板的来源溯源(URL、日期、适用文档)
  54. 文档模板/ # GJB 438C-2021 拆分的 20 份文档章节骨架(SRS/SDD/DBDD/STR…)
  55. 合规与标准/ # 标准引用核对表(标准号/状态/日期,不收录正文)
  56. 素材库/ # 素材库模板与说明(实际素材放在写作项目目录)
  57. scripts/index_materials.py # 索引脚本,零参数运行
  58. scripts/test_index_materials.py # 脚本测试(标准库,无第三方依赖)
  59. scripts/split_gjb_templates.py # GJB 438C 模板拆分工具
  60. examples/ # 写作示例(浅 vs 深对照)
  61. ```
  62. ## 脚本
  63. | 命令 | 作用 |
  64. |---|---|
  65. | `python scripts/index_materials.py` | 生成 `knowledge/.index.json` 与「当前工作目录」的 `素材库/.index.json`(无参数) |
  66. | `python scripts/test_index_materials.py` | 运行索引脚本测试(当前 16 项,全部通过) |
  67. 索引脚本特性:仅支持 `.md` / `.txt`(UTF-8 / GBK);忽略隐藏文件与其他格式;chunk 带行区间与 preview,便于按需回读;只识别「当前工作目录下的 `素材库/`」,不存在时不报错、仅生成知识库索引。
  68. ## 扩展知识库
  69. - **新增领域**:在 `knowledge/` 下建目录(如 `knowledge/视频AI/`),按八段卡片格式写卡片(格式见 [knowledge/README.md](knowledge/README.md)),并在 [SKILL.md](SKILL.md) 的技术路由表中补一行关键词映射
  70. - **新增场景文档**:在 `references/` 下加场景规范,并在 SKILL.md 场景路由表登记
  71. - **其他格式素材**:docx/pdf/xlsx 等先转成 md/txt 再放入 `素材库/`
  72. ## 添加素材后如何生成索引
  73. 新增 / 修改 / 删除素材后,需要重新生成索引,skill 才能检索到最新内容。脚本**无参数**,**必须在写作项目的工作目录下运行**(脚本只认「当前工作目录下的 `素材库/`」)。
  74. ```bash
  75. # 1. 在写作项目根目录创建 素材库/(首次使用)
  76. mkdir 素材库
  77. # 2. 放入素材(仅 .md / .txt,UTF-8 / GBK 均可,允许子目录)
  78. cp 招标文件摘编.md 素材库/
  79. cp -r 历史标书/ 素材库/
  80. # 3. cd 到项目根目录,用 skill 脚本的完整路径运行(无参数)
  81. python ~/.cursor/skills/technical-proposal-expert/scripts/index_materials.py
  82. ```
  83. 成功时终端会打印形如下面两行:
  84. ```text
  85. 已生成 knowledge/.index.json:N 个文件,M 个块,共 K 字
  86. 已生成 素材库/.index.json:N 个文件,M 个块,共 K 字
  87. ```
  88. 约束与要点:
  89. - `cd` 到哪个目录,索引的就是哪个目录的 `素材库/`;从 skill 根目录运行只索引内置 `knowledge/`
  90. - 素材目录名固定为中文 `素材库/`,改名(材料 / 资料)会识别不到
  91. - 仅支持 `.md` / `.txt`,其他格式(docx / pdf / xlsx)先转换
  92. - 隐藏文件 / 隐藏目录自动忽略,不用清理
  93. - 当前目录下没有 `素材库/` 时不会报错,只生成 `knowledge/.index.json` 并提示
  94. - 写作时 skill 读取的是已生成的 `.index.json`,索引不用每次都跑;素材有变更时再跑一次即可
  95. - 想验证脚本本身是否健康:`python scripts/test_index_materials.py`(标准库,16 项用例)
  96. ## 当前状态与边界
  97. - 知识库已有 46 份内容:20 份 GJB 438C 文档模板 + 26 份技术卡片(微服务 / 云原生 / 大数据 / 物联网 / 测试 / 高可用 / 等保 / 信创 / 数据治理),来源见 `knowledge/00-来源登记.md`;`AI与视频分析 / 低代码与BPM / 移动端` 等目录仍待补充卡片
  98. - 素材仅支持 `.md` / `.txt`,其他格式先转换

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.