mcpField
Q
quality-documentation-manager

quality-documentation-manager

github.com/alirezarezvani文档处理28.9k808 次安装3 天前更新
代码仓库

关于 quality-documentation-manager

面向 ISO 13485 质量管理体系的文档控制 Skill,涵盖编号、审核批准、变更管理和电子记录合规,并提供元数据验证脚本。

主要功能

  1. 01文档生命周期管理
  2. 02编号规则与主清单
  3. 03审核和批准流程
  4. 04变更控制与影响评估
  5. 0521 CFR Part 11 控制
  6. 06文档元数据验证脚本

适用场景

  1. 01建立受控文档流程
  2. 02规范文档编号和修订
  3. 03评估变更并记录批准
  4. 04检查文档及电子签名要求

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/alirezarezvani/claude-skills --skill quality-documentation-manager

安装后在 Claude Code 中输入/quality-documentation-manager确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
21cfr11-compliance-guide.md
document-control-procedures.md
scripts/
document_validator.py
document_version_control.py

详细介绍

质量文档管理器

面向符合 ISO 13485 的质量管理体系设计并管理文档控制系统,包括编号约定、审批工作流、变更控制以及电子记录合规。


目录


文档控制工作流

实现从创建到废止的全过程文档控制:

  1. 按照编号程序分配文档编号
  2. 使用受控模板创建文档
  3. 送交必要的评审人员进行评审
  4. 处理评审意见并记录回复
  5. 获取所需的审批签名
  6. 指定生效日期并发布
  7. 更新文档总清单
  8. 验证: 文档可在使用地点获取;已废止的版本已移除
文档生命周期阶段
阶段定义所需操作
草稿正在创建或修订中作者编辑,不得用于实际使用
评审已分发进行评审评审人员提供反馈
已批准已获得全部签名可进行培训/发布
生效培训完成,已放行可供使用
被替代已被较新版本取代移出现行使用
已废止不再适用按保存期限归档
文档类型与前缀
前缀文档类型典型内容
QM质量手册QMS 概述、范围、方针
SOP标准作业程序过程层面的程序
WI作业指导书任务层面的逐步操作
TF模板/表单受控表单
SPEC规范产品/过程规范
PLN计划质量/项目计划
按文档类型划分的必需评审人与审批人
文档类型必需评审人必需审批人
SOP过程负责人、QAQA 经理、过程负责人
WI区域主管、QA区域经理
SPEC工程部、QA工程经理、QA
TF过程负责人QA
设计文档设计团队、QA设计控制授权人

文档编号系统

分配一致的文档编号,以便识别和检索。

编号格式

标准格式:PREFIX-CATEGORY-SEQUENCE[-REVISION]

Example: SOP-02-001-A

SOP = Document type (Standard Operating Procedure)
02  = Category code (Document Control)
001 = Sequential number
A   = Revision indicator
类别代码
代码职能领域说明
01质量管理QMS 程序、管理评审
02文档控制本领域
03人力资源培训、能力
04设计与开发设计控制过程
05采购供应商管理
06生产制造程序
07质量控制检验、测试
08CAPA纠正/预防措施
09风险管理ISO 14971 过程
10注册事务申报、合规
编号工作流
  1. 作者向文档控制部门申请文档编号
  2. 文档控制部门核实类别分配
  3. 文档控制部门分配下一个可用序号
  4. 将编号记录在文档总清单中
  5. 作者使用分配的编号创建文档
  6. 验证: 编号格式符合标准;总清单中无重复编号
版本编号规则
变更类型版本递增方式示例
重大修订递增主编号Rev 01 → Rev 02
次要修订递增子编号Rev 01 → Rev 01.1
管理性修订不变更或添加字母后缀Rev 01 → Rev 01a

完整的编号指南请参阅 references/document-control-procedures.md。


审批与评审流程

在文件发布前,须完成所需的评审与审批。

评审工作流
  1. 作者完成文件草稿
  2. 作者通过流转表单或 DMS 提交评审
  3. 根据文件类型指定评审人
  4. 评审人在评审期限内(5-10 个工作日)提出意见
  5. 作者处理意见并记录回复
  6. 作者提交修订后的文件
  7. 审批人签署并注明日期
  8. 验证: 所有必需的评审人均已完成评审;所有意见均已处理并记录处置结果
意见处置
处置结果所需操作
采纳按原样采纳意见
修改后采纳采纳并作出修改,记录理由
不采纳不予采纳,记录理由
延后在未来修订中处理,记录原因
审批矩阵
Document Level 1 (Policy/QM): CEO or delegate + QA Manager
Document Level 2 (SOP): Department Manager + QA Manager
Document Level 3 (WI/TF): Area Supervisor + QA Representative
签名要求
要素要求
姓名签署人的正式姓名
签名手写签名或电子签名
日期签名的日期
角色签署人的职能或角色

变更控制流程

通过评审与审批,系统化地管理文件变更。

变更控制工作流
  1. 识别文件变更需求
  2. 填写附理由说明的变更申请表
  3. 文件控制人员分配变更编号并登记申请
  4. 转交评审人进行影响评估
  5. 根据变更分类获取相应审批
  6. 作者实施已批准的变更
  7. 更新版本号和变更历史
  8. 验证: 变更内容与批准范围一致;变更历史完整
变更分类
类别定义审批级别示例
管理性变更不影响内容文件控制错别字、格式
次要变更有限的内容变更流程负责人 + QA澄清说明
重大变更重要的内容变更完整评审周期新增要求
紧急变更紧急的安全/合规问题加急审批 + 事后追溯安全问题
影响评估清单
影响领域评估问题
培训变更是否需要重新培训?
设备变更是否影响设备或系统?
验证变更是否需要重新验证?
法规变更是否影响法规申报?
其他文件哪些相关文件需要更新?
记录哪些记录受到影响?
变更历史记录

每份文件都必须包含变更历史:

| Revision | Date | Description | Author | Approver |
|----------|------|-------------|--------|----------|
| 01 | 2023-01-15 | Initial release | J. Smith | M. Jones |
| 02 | 2024-03-01 | Updated workflow | J. Smith | M. Jones |

21 CFR Part 11 合规

实施电子记录与电子签名控制,以满足 FDA 合规要求。

Part 11 适用范围
适用于不适用于
FDA 法规要求的记录纸质记录
提交给 FDA 的记录内部非法规类文件
所需记录上的电子签名一般电子邮件通信
电子记录控制
  1. 验证系统的准确性与可靠性
  2. 为所有变更实施安全的审计追踪
  3. 限制仅授权人员访问系统
  4. 生成可供人阅读的准确副本
  5. 在整个保存期内保护记录
  6. 验证: 审计追踪能记录所有变更的操作人、内容与时间
审计追踪要求
要求实现方式
安全用户无法修改
计算机生成系统自动创建
带时间戳记录每次操作的日期和时间
原始值保留之前的值
用户身份记录每次变更的执行人
电子签名要求
要求实现方式
个人专属不得在不同人员之间共享
至少两个组成部分最低要求为用户 ID + 密码
签名显示显示姓名、日期/时间和签署含义
与记录关联不得剪切或复制
签名显示

每个电子签名必须显示:

要素示例
打印姓名John Smith
日期和时间2024-03-15 14:32:05 EST
含义批准发布
系统控制检查表

访问控制:

  • 每人拥有唯一的用户 ID
  • 强制执行密码复杂度要求
  • 多次登录失败后锁定账户
  • 长时间无操作后会话超时

审计追踪:

  • 记录所有记录的创建
  • 记录所有修改,并包含旧值/新值
  • 捕获用户身份
  • 所有条目均带有日期/时间戳

安全:

  • 基于角色的访问控制
  • 静态数据和传输中数据均加密
  • 定期备份并进行恢复测试

有关详细的合规要求,请参阅 references/21cfr11-compliance-guide.md。


参考文档

文档控制程序

references/document-control-procedures.md 包含:

  • 文档编号体系及格式
  • 文档生命周期阶段及转换
  • 审核与批准工作流详情
  • 含分类标准的变更控制流程
  • 分发与访问控制方法
  • 记录保留期限及处置程序
  • 文档总清单要求
21 CFR Part 11 合规指南

references/21cfr11-compliance-guide.md 包含:

  • Part 11 的范围与适用性
  • 电子记录要求(§11.10)
  • 电子签名要求(§11.50、11.100、11.200)
  • 系统控制规范
  • 验证方法与文档
  • 合规检查表及差距评估模板
  • 常见 FDA 缺陷及预防措施

工具

文档验证器
# Validate document metadata
python scripts/document_validator.py --doc document.json

# Interactive validation mode
python scripts/document_validator.py --interactive

# JSON output for integration
python scripts/document_validator.py --doc document.json --output json

# Generate sample document JSON
python scripts/document_validator.py --sample > sample_doc.json

验证内容:

  • 文档编号约定的合规性
  • 标题和状态要求
  • 日期验证(生效日期、复审到期日)
  • 按文档类型划分的批准要求
  • 变更历史的完整性
  • 21 CFR Part 11 控制项(审计追踪、签名)
示例文档输入
{
  "number": "SOP-02-001",
  "title": "Document Control Procedure",
  "doc_type": "SOP",
  "revision": "03",
  "status": "Effective",
  "effective_date": "2024-01-15",
  "review_date": "2025-01-15",
  "author": "J. Smith",
  "approver": "M. Jones",
  "change_history": [
    {"revision": "01", "date": "2022-01-01", "description": "Initial release"},
    {"revision": "02", "date": "2023-01-15", "description": "Updated workflow"},
    {"revision": "03", "date": "2024-01-15", "description": "Added e-signature requirements"}
  ],
  "has_audit_trail": true,
  "has_electronic_signature": true,
  "signature_components": 2
}

文档控制指标

跟踪文档控制体系的运行绩效。

关键绩效指标
指标目标计算方式
文档周期时间<30 天从草稿到生效的平均天数
审核完成率>95%按时完成的审核数 / 审核总数
变更请求积压<10月末未关闭的变更请求数
复审逾期率<5%超过复审日期的文档数 / 生效文档总数
审计发现率每次审计 <2 项每次内部审计中的文档控制发现项数
定期复审计划
文档类型复审频率
政策每 3 年
SOP每 2 年
WI每 2 年
规格按需或随产品变更进行
表单/模板每 3 年

法规要求

ISO 13485:2016 第 4.2 条
子条款要求
4.2.1质量管理体系文件
4.2.2质量手册
4.2.3医疗器械文件(技术文档)
4.2.4文件控制
4.2.5记录控制
FDA 文档与记录控制:QMSR 下的 ISO 13485 §4.2(旧版 QSR 条款,仅供历史参考)

⚠️ 状态:QMSR 过渡(自 2026-02-02 起生效):FDA 质量管理体系法规(QMSR)最终规则(89 FR 7496)修订了 21 CFR Part 820,以引用方式纳入 ISO 13485:2016,并删除了旧版 QSR 的分条结构。下表中的条款编号(820.40/.180/.181/.184/.186)在 CFR 中已不存在,仅作为熟悉的索引保留。当前文档/记录控制的依据是 ISO 13485:2016 §4.2(尤其是 §4.2.4 文件控制、§4.2.5 记录控制),医疗器械文档(medical device file)见 §4.2.3,保留的记录补充要求见 21 CFR 820.35。在当前合规文件中,请引用 ISO 13485 条款,而不是 820.x 编号。

旧版 QSR 条款(历史,2026 年前)要求QMSR 下的现行依据(旧版 QSR 仅供索引)
820.40文件控制ISO 13485 §4.2.4
820.180记录的一般要求ISO 13485 §4.2.5 + 21 CFR 820.35(保留)
820.181器械主记录ISO 13485 §4.2.3(医疗器械文档)
820.184器械历史记录ISO 13485 §4.2.5 + 21 CFR 820.35(保留)
820.186质量体系记录ISO 13485 §4.2.5 + 21 CFR 820.35(保留)
常见审核发现
发现问题预防措施
在用文件已过时实施分发控制
缺少批准签名发布前强制执行工作流
变更历史不完整每次修订时要求更新历史
没有定期评审计划建立并执行评审日历
审计追踪不充分验证 DMS 是否符合 Part 11 要求

决策规范: 本 Skill 中的校验脚本检查的是结构与完整性,并不能证明某份文档或记录合规。批准与发布决策应由您及文件所有者依据受控程序作出;有关法规分类或提交记录的问题,请交由法规事务(Regulatory Affairs)部门处理。

评论

支持 Markdown