基于 scientific-agent-skills 构建 ISO 质量管理体系文件控制程序模板从受控文档元数据到审计证据链的落地指南【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills本文以 skills/iso-standards-readiness/assets/templates/procedures/document-control-procedure-template.md 为骨架结合仓库内同目录的脚本与引用文档展开。它是iso-standards-readiness技能包中面向 ISO 13485 医疗器械 QMS、ISO/IEC 17025 检测与校准实验室、ISO 15189 医学实验室等标准的受控文件与记录控制程序工作模板。读者学完后可以理解文件控制程序应覆盖的九大要素受控元数据、职责分离、文档生命周期、记录生命周期、外部源版本控制、电子系统验证、变更与培训影响、登记册与审计证据、发布清单将模板转换为组织自身受控程序的草稿并用仓库自带的audit_document_records.py等确定性脚本对登记册做结构化校验。1. 模板定位受控文件与记录控制程序为什么需要工作模板在任何一个质量管理体系QMS中文件与记录控制都是最先被审核、也最容易暴露结构性缺陷的环节。iso-standards-readiness技能包把这一主题沉淀为一个独立的工作模板其使用边界在 SKILL.md 中被严格限定该技能只负责组织受控范围、受控文件、实施记录、可追溯性与就绪证据供授权人员对照既定标准进行实质审查它不包含任何标准条文、不执行审核、不能认证或认可任何东西。模板开篇即用醒目的状态块声明STATUS: DRAFT EXAMPLE — NOT APPROVED — NO COMPLIANCE CLAIM该结构不是已发布的程序。它不决定保留期限、法规适用性、符合性或者认证。授权管理层、RA/QA、法务/法规、过程负责人和文件控制人员必须批准组织特定的控制措施。ISO 出版物受版权保护请使用授权副本不要在此粘贴其文本。这一声明在 SKILL.md 的Non-negotiable boundary不可协商的边界一节得到呼应技能绝不能根据模板、清单、文件名、关键词、文档数量、百分比或脚本结果去推断实施情况、能力、符合性或就绪度。也就是说本模板的产出永远应当被标注为供授权人员实质审查的草稿性证据准备材料未决决策应作为阻塞项保留而不是由 Agent 代为解决。从仓库结构看该模板与 CAPA-procedure-template.md、quality-manual-template.md 共同构成管理层体系文档Management-system documentation三件套质量手册描述体系范围与治理架构文件控制程序管理文档与记录的整个生命周期CAPA 程序管理不符合项到纠正预防措施闭环。三者共享 owner/status/evidence/approval 四要素字段且全部是draft/pending占位状态——任何分发出去的模板都必须在技能目录之外另行复制并受控后使用绝不可以在分发的模板上直接编辑成已批准记录。2. 受控文档元数据每个受控文档的身份与批准证据模板第一节要求为程序本身建立元数据表字段包括字段填写示例文档 ID/版本ID/revision所有者accountable role问责角色状态draft/in-review/approved生效日期YYYY-MM-DD after approval批准后的日期证据仓库controlled location受控位置变更/取代记录IDs同时必须建立批准记录表至少覆盖三个批准角色批准角色指定批准人状态日期批准证据过程负责人Process ownername/rolependingdateIDRA/QAname/rolependingdateID体系负责人System ownername/rolependingdateID这里的元数据字段并不是随意设计的。对照 audit_document_records.py 的校验逻辑可以看到状态枚举、批准结构和证据字段都有一一对应的确定性检查文档状态枚举DOCUMENT_STATUSES {draft, in-review, effective, obsolete}与模板元数据中的状态枚举一致当状态为effective时脚本强制要求approval.status approved见require_approvedstatus effective并且必须提供effective_date日期当状态为obsolete时要求补充disposition处置说明与obsolete_date通用校验字段包括owner非占位文本、evidence受控证据 ID 数组、approval状态/批准人/日期、source_refs来源/版本引用这些在 _common.py 的Review类中统一实现。脚本对占位符的处理尤其值得注意_common.py中的PLACEHOLDER_RE会把...、tbd、todo、unknown、n/a without rationale等全部判定为占位文本并在TEXT_REQUIRED检查中产生gap级别发现项。换言之用尖括号占位在结构化校验层面就是一个缺陷——这正是模板坚持占位符写法的原因让使用者意识到这些字段必须由组织真实填充。3. 目的、范围与接口文件控制程序的边界声明模板第 1 节要求明确声明受控文件覆盖范围types, systems, sites, products类型、体系、现场、产品记录覆盖范围types, systems, sites, products外部来源覆盖范围标准、法规、指南、客户与供应商规范、产品特定来源接口Interfaces变更控制、培训、验证、数据完整性、网络安全、供应商控制、产品文件、投诉/CAPA、审核与管理评审。在 references/evidence-architecture.md 中这套体系被细化为五层受控证据层次结构来源与适用性层Source and applicability layer带确切版本/日期的来源台账、范围录入、授权适用性决策、法规/产品要求矩阵治理与政策层Governance and policy layerQMS 范围与质量手册、质量方针/目标、组织架构与角色授权、管理代表任命、过程交互图、管理评审记录过程控制层Process-control layer文件记录与外部来源控制、风险管理、设计与开发、供应商、生产与服务、验证、监视测量设备、可追溯性、投诉与上市后监督、不符合与 CAPA、内审与管理评审、能力培训、变更控制等受控过程产品与技术证据层Product and technical evidence layer按产品/类型/族建立的受控文件架构实验室等效按方法/被测量/检验项目组织实施记录层Implementation-record layer用抽样记录证明程序描述的并非纸上流程而是真实发生过的活动。模板要求文件控制程序明确声明覆盖外部来源标准、法规、指南、客户规范这与第 5 层中的外部来源与版本控制一节直接衔接要求声明接口则保证文件控制程序不是孤立文档而是与变更控制、培训、验证、CAPA 等过程形成闭环。evidence-architecture 中的一句话点明了这一节的本质程序描述控制记录展示实际发生的事Procedures describe controls; records show what happened.因此范围与接口声明必须能映射到具体的受控文件和记录系列。4. 角色与职责分离文档控制中最容易被忽略的治理问题模板第 2 节以表格列出五类角色及其职责矩阵角色权力/责任独立性或访问限制代理人证据批准文档所有者Document ownerentryentryroleIDID记录所有者Record ownerentryentryroleIDID评审者ReviewerentryentryroleIDID批准者ApproverentryentryroleIDID系统管理员System administratorentryentryroleIDID职责分离segregation of duties在此的含义是起草、评审、批准、发布、系统维护应当是不同角色行使的权力且批准者的独立性如内审员不得审核自己的工作应被显式记录。evidence-architecture.md第 2 层要求在治理层维护组织架构图、角色权力、代表、独立性与升级路径gap-analysis-checklist.md 的Scope, roles, and source basis一节进一步要求授权管理代表、RA/QA 所有者、过程所有者、文件/记录所有者、代表与升级路径均有文档记录内审、放行、投诉/可报告性、不符合处置、CAPA 关闭与变更批准的独立性与权力已定义。对于实验室场景quality-manual-guide.md还补充了授权签字人authorized signatories的要求维护当前授权名单、每人的授权范围及其能力证据——这是 ISO/IEC 17025 与 ISO 15189 特有的角色控制与医疗设备 QMS 的五角色表互补。5. 文档生命周期从起草请求到过时归档的六阶段控制模板第 3 节给出文档生命周期的六个阶段及每阶段必须的控制阶段必需控制所有者状态证据批准请求/起草需求、范围、来源/版本、作者roledraftIDID评审技术、过程、RA/QA、关联文档影响roledraftIDID批准/发布指定权力、日期、版本、生效日期roledraftIDID分发/使用访问、使用点版本、副本状态roledraftIDID变更理由、影响、验证/培训、关联更新roledraftIDID过时撤回、归档、保留副本标识roledraftIDID模板随后给出关键提示必须定义标识符、版本方案、紧急变更、打印副本、翻译、电子签名与受控导出的批准规则不要假设下载或打印的文件仍然受控。这与 evidence-architecture 的fail-closed document register默认关闭的文档登记册要求一致每个受控文档必须捕获唯一 ID、标题、类型、所有者、版本与状态来源/版本引用与变更理由、评审者/批准者与批准证据、生效日期与培训影响、关联文档/表单/记录/系统/产品/供应商/过程、过时/被取代处置、受控位置与访问分类。在脚本层面文档生命周期的变更与取代关系有专门校验audit_document_records.py会检查每条文档记录的supersedes字段若该字段非空但引用的 ID 不在同一登记册的文档 ID 集合中则产生REFERENCE_MISSING发现项must reference another document id in this register。这从工具层面强制了版本取代必须可追溯的要求。另外值得注意文档生命周期请求/起草阶段就要求记录来源/版本这与 SKILL.md 核心工作流 Step 2冻结来源/版本证据相呼应——不要用搜索引擎摘要作为受控要求文本发布方发布新版本时也不应静默更新已纳入的版本因为 FDA 纳入的是特定版本的 ISO 13485 文本。6. 记录生命周期与数据完整性创建、更正、保留与处置模板第 4 节以表格列出记录的八项控制及其组织特定实现方法控制组织特定方法所有者状态证据批准创建/归属Creation/attributionentryroledraftIDID清晰/完整Legibility/completenessentryroledraftIDID同步记录Contemporaneous entryentryroledraftIDID更正/审计追踪Corrections/audit trailentryroledraftIDID访问/安全Access/securityentryroledraftIDID备份/恢复Backup/recoveryentryroledraftIDID检索RetrievalentryroledraftIDID保留/处置Retention/dispositionentryroledraftIDID模板特别强调每个记录类型的保留期限必须引用已批准的依据本模板不提供通用期限。这一原则在 evidence-architecture 的 Retention: no universal period 一节被展开为完整决策框架不要使用泛化的5–10 年或设备寿命作为完整保留计划而应协调现行标准与法规来源产品/设备寿命与市场特定期限投诉、警戒、可追溯性、临床/性能、技术文档与证书义务法律保全、隐私、合同与业务要求系统迁移与持久检索能力。并记录所选择的期限、起始事件、来源/版本、理由、所有者、批准、处置方法与保全覆盖hold override。audit_document_records.py对记录系列的字段校验则具体化为retention_period批准期限、retention_basis官方/合同/业务来源与理由、storage_and_integrity_controls访问、完整性、备份、审计追踪控制、retrieval_method、disposition_method且记录状态枚举为{active, archived, disposed}若状态为disposed还要求提供disposition_date与disposition_authorized_by。记录所有者必须批准require_approvedTrue没有批准状态的记录在结构上就不合格。7. 外部来源与版本控制标准、法规与指南的受控管理模板第 5 节用一张外部来源台账表组织信息并给出五项必需控制来源 ID发布者/标题版本/日期授权位置适用性所有者最近时效审查影响记录状态批准IDentryentryentryroledateIDreview-dueID五项必需控制从授权来源获取标准并保留许可限制记录纳入各管辖基础的确切版本/版次监控官方发布方不要依赖搜索摘要作为受控文本变更 QMS 文档前执行并批准影响评估区分 ISO、FDA QMSR/eCFR、MDSAP、EU MDR/IVDR/MDCG 与产品特定来源不要把它们视为可互换。外部来源的时效性在脚本中有硬性状态约束EXTERNAL_STATUSES {current, review-due, superseded}若状态不是current脚本直接产生SOURCE_NOT_CURRENT发现项source requires documented impact assessment or replacement。若状态为current则强制要求批准证据与last_currency_review日期。针对当前基线SKILL.md 的 Current baseline 一节给出带日期的权威来源基线任何时间敏感陈述前都应先读 references/source-ledger.md 确认例如ISO 13485:2016 第 3 版2025 年系统评审后确认EN ISO 13485:2016/A11:2021 是欧洲修订版而非 ISO 国际修订 1:2021ISO 14971:2019 第 3 版2025 年确认配套 ISO/TR 24971:2020不存在ISO 14971 证书ISO/IEC 17025:2017 第 3 版仍现行ISO 15189:2022 第 4 版取代 2012 版并入原 ISO 22870 的 POCT 要求其认可过渡已于2025 年 12 月结束FDA QMSR 自2026-02-02起生效并执行Part 820 更名为《质量管理体系法规》QSIT 被合规计划 7382.850 取代MDSAP 现行审核方法为 MDSAP AU P0002.0102026-02-02 版全球认可合作组织Global Accreditation Cooperation Incorporated于 2026-01-01 全面运行取代 ILAC 与 IAF。这些基线条目在模板中并未列出模板保持标准无关性但模板第 5 节的区分来源控制正是为了支持此类跨管辖来源管理——将 ISO、FDA、MDSAP、EU 各自的版本/日期独立记录而不是混为一谈。8. 电子系统与软件验证先批准再上线模板第 6 节针对承载受控文件的电子系统给出台账系统/用途预期用途风险依据访问/审计追踪控制验证证据变更/再验证触发所有者批准systementryentryentryIDentryroleID并给出硬性要求在授权所有者批准预期用途、验证证据、访问角色、数据迁移、备份/恢复与变更控制之前不得发布电子工作流。证据架构层面evidence-architecture.md的过程控制层要求评估过程、设备、检验方法、软件验证实施记录层要求记录软件预期用途、风险、验证、发布、事件与变更。gap-analysis-checklist 的 Production, service, validation, and software 一节细化了 QMS 与生产软件的证据项预期用途、风险、需求、配置、访问/数据完整性控制、验证、发布、事件、备份/恢复、供应商与变更/再验证证据。这与技能包的整体安全设计一致SKILL.md 的 CLI 行为一节明确所有捆绑脚本只使用 Python 标准库、不发起网络请求、拒绝符号链接输入、拒绝重复 JSON 键与非有限数字、不使用动态求值或 pickle、将清单本身视为受控组织记录。电子系统验证关注的是组织自身的受控系统如文档管理系统、LIMS而技能提供的本地脚本只是验证元数据的辅助工具。9. 变更与培训影响每个变更记录必须携带的信息模板第 7 节列出每个变更记录必须包含的内容理由、受影响的产品/现场/过程/文档/记录来源/版本与法规影响评审风险、验证、软件、供应商与上市后影响培训人群与生效使用前的完成证据实施验证、所有者、状态、证据与批准。这套字段在 gap-analysis-checklist 的 Training, competence, and change control 一节得到完整呼应变更应识别来源/版本、理由、受影响范围、风险、产品、验证/软件、供应商、生产、文档/记录、培训、上市后与法规/认证影响变更应有实施计划、批准、必要时回滚/应急方案、验证与关闭证据。培训则要求在独立工作或文档生效使用之前完成培训并评估有效性。从文件控制的角度看任何受控文档的变更都不能孤立进行——它必须同时触发对关联文档、记录、培训与验证证据的更新。这正是模板元数据表里 Change/superseded record 字段以及文档生命周期变更阶段关联更新控制存在的意义也是audit_document_records.py校验supersedes引用完整性的原因。10. 登记册与审计证据六类受控登记册模板第 8 节列出文件控制程序应当维护的登记册登记册所有者状态位置评审频率/依据证据批准主文档清单Master document listroledraftlocationbasisIDID记录保留计划Record retention scheduleroledraftlocationbasisIDID外部来源台账External source ledgerroledraftlocationbasisIDID访问/角色登记册Access/role registerroledraftlocationbasisIDID培训/变更登记册Training/change registerroledraftlocationbasisIDID过时/处置日志Obsolete/disposition logroledraftlocationbasisIDID仓库提供的 document-register-template.json 正是这套登记册的机器可读载体其顶层结构包含metadata登记册 ID、评审日期、所有者、状态、证据、批准、来源引用、documents、records、external_sources四个数组。audit_document_records.py的validate()函数按这四个数组逐条校验并输出统计指标documents / external_sources / records 数量与结构化发现项。运行方式在技能目录内PYTHONDONTWRITEBYTECODE1 python3 skills/iso-standards-readiness/scripts/audit_document_records.py \ skills/iso-standards-readiness/assets/templates/document-register-template.json注意分发模板会故意校验失败fail closed——模板中的占位符和pending批准状态必然触发TEXT_REQUIRED、APPROVAL_PENDING等发现项。正确用法是把模板复制到技能目录之外的组织受控位置填充真实的文档 ID、所有者、批准与证据 ID 后再运行校验。退出码语义见 SKILL.md0表示对提供的字段未发现结构性问题不是合规、符合性、能力或认可结果1表示发现结构/证据缺口2表示无效或不安全输入包括未在清单中的--standard值。11. 发布清单文件控制程序正式发布前的七项自检模板以发布清单Release checklist收尾范围涵盖文档、记录、外部来源与电子系统所有者、状态、证据、来源版本与批准均为显式访问、完整性、检索、保留、处置与审计追踪已定义变更、验证、软件、供应商与培训影响已关联未断言通用保留期限或自动适用性结论未将任何模板或脚本结果描述为合规或认证生效日期前所需的人工批准已全部完成。最后三条尤其关键它们不是形式条款而是 SKILL.md Non-negotiable boundary 的直接落地模板不提供通用保留期限——保留期限必须引用经批准的依据对应第 6 节模板或脚本结果绝不等于合规或认证——_common.py中内置的免责声明明确写着零发现项结果不建立法律适用性、法规合规性、对任何标准的符合性、认证、认可、MDSAP 可接受性、EU 符合性或检查就绪性人工批准不可省略——audit_document_records.py对effective文档强制要求approved状态对记录强制要求批准未批准的批准记录会产生APPROVAL_PENDING发现项。12. 实战落地从模板到受控程序的完整路径将以上要素串成一条可执行的落地路径与 SKILL.md 的八步核心工作流对齐声明标准与范围用 scope-intake-template.json设备 QMS或实验室/医学实验室范围模板声明标准、目的与授权所有者未决适用性保持HUMAN_DECISION_REQUIRED阻塞项冻结来源基线按模板第 5 节建立外部来源台账记录确切版本/日期与时效审查盘点受控文档与记录按模板第 3、4、6 节建立主文档清单、记录保留计划与电子系统台账并用audit_document_records.py做结构化校验评审过程实施按模板第 7 节将每份受控程序与抽样实施记录关联明确变更、培训与 CAPA 接口运行车道相关的聚焦检查设备车道用 check_traceability.py注意这是设计/风险可追溯性不是计量可追溯性通用车道用 check_capa.py 与 check_supplier_controls.py单独处理车道特定的监管证据美国设备车道用 check_qmsr_transition.py实验室车道无等效捆绑检查CLIA/许可证据由授权合规负责人持有组装受控就绪清单用 evidence-manifest-template.json 与 validate_evidence_manifest.py、gap_analyzer.py 生成域级差距视图注意not-assessed不等于not-applicable人工评审与受控交接呈现声明范围、来源/版本基线、抽样证据及其局限、按过程与风险分组的结构性发现、带责任人与日期的行动项、批准状态与下一决策的责任方标题统一使用供授权人工评估的草稿证据评审绝不使用证书合规报告审核通过检查就绪等措辞。其中步骤 3 直接由本文主题模板支撑——文件与记录控制程序是 QMS 的骨架而其落地质量最终取决于登记册是否默认关闭fail closed任何未知、占位、未批准、不受控或不可访问的条目都是缺口而不是被假设的证据。【免费下载链接】scientific-agent-skillsTurn any AI agent into an AI Scientist. The #1 Agent Skills library for science, used by 190,000 scientists worldwide. 165 ready-to-use validated skills plus 100 scientific databases covering biology, chemistry, medicine, and drug discovery. Compatible with Cursor, Claude Code, Codex, Pi, Antigravity, and the open Agent Skills standard.项目地址: https://gitcode.com/GitHub_Trending/cl/scientific-agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考