Agent Skills
返回列表
软件过程文档专业审核

软件过程文档专业审核

行业专业 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_be284157/software-process-doc-audit。

技能介绍

要解决什么问题

轨道交通、功能安全类项目里,SRS、SDD、SRTM、STPr、SPMP 等交付物往往成包提交,甲方或第三方顾问的评审意见非常具体:缺哪份文档、哪个 REQ_SRS_02005 在 STPr 里没有对应用例、版本号对不上、出现 “To be completed in the next revision” 会直接打回。人工对照 EN 50128 / IEC 61508 语境下的习惯,既费时间又容易漏维度。

本技能不是自动化扫描工具,而是把 1,000+ 条真实顾问评语 归纳成可复用的审阅思路:你提供原始过程文档正文(粘贴、Markdown、或可读的 PDF/Word 文本),模型按顾问逻辑逐条找问题,并用 phrasebook 里常见的表述方式输出结论。

核心能力与审阅步骤

审阅围绕六个维度展开:

  • Completeness(完整性):交付清单是否齐全、引用表是否漏列、是否已过期版本
  • Traceability(可追溯性):SRS 需求 ID → SRTM → SDD 设计元素 → STPr 测试用例,不允许孤儿需求
  • Consistency(一致性):跨文档版本号、ID 格式、术语是否一致,陈述是否矛盾
  • Test Coverage(测试覆盖):每个 SRS 需求是否至少有一条 STPr 用例,拒绝 “下版再补”
  • Conformance(标准符合性):是否点名 MISRA-C、EN 50128 等,并说明如何验证符合性
  • Document Control(文档控制):封面与交叉引用中的修订号、Open/Closed 状态、变更历史是否自洽

典型流程:识别文档类型(如 SRS / SDD / STPr)→ 按维度套用顾问逻辑 → 输出带具体章节、需求 ID、版本号的问题描述(例如:“STPr does not test all requirements listed in the SRS.”)。若你提供多份文档,可按 SRS→SDD→STP 做交叉文档审阅。

适用边界

| 适用 | 不适用 |
|------|--------|
| 用户发送 原始 SRS、SDD、STPr、SRTM、SPMP 等并请求审核/检查 | 把评审意见表、comment sheet 当作被审对象(那些仅用于学习顾问话术) |
| 触发语如「审核这个 SRS」「audit this SDD」 | 硬件规格、合同等非软件过程文档 |
| 你说「跳过一致性检查」「再检查一遍」时按指令调整维度 | 期望一键脚本、GUI 或自动解析流水线 |

结论粒度应对齐真实顾问:指出具体 ID 与不一致点,而不是泛泛的 “建议加强质量”。

使用场景

  • 轨道交通或安全相关项目里程碑前,对照 SRS 逐条核对 STPr 是否覆盖全部需求 ID,避免以「未测全需求」被退回。
  • 甲方指出 SRS、SDD、STPr 版本或引用不一致后,需交叉审阅三份文档的修订号、术语与 REQ 编号格式。
  • 初稿 SRTM 定稿前,检查每条 SRS 需求是否链到 SDD 设计元素与 STPr 用例,并找出无下游的孤儿需求。
  • 按合同交付清单组包 SPMP/SRS/SRTM 等文档前,核对索引表是否列全应交付件、有无过期或被 supersede 的版本。

适合人员

  • 负责 EN 50128 / IEC 61508 项目软件验证包的测试工程师,提交 STPr 前需自行发现对 SRS 的漏测与「下版再补」表述。
  • 同时维护 SRS、SDD、SRTM 多份过程文档的系统工程师,resubmit 前希望按顾问常用的六维度做一轮结构化自检。
  • 协助第三方质量顾问整理评审材料的工程助理,需把长文档中的问题收敛成带具体 REQ ID 与章节的可回复清单。
  • 管理软件基线与文档版本的配置管理员,需核对封面修订号、Open/Closed 状态与文内交叉引用是否自洽。