合规:实践检查表 → 机读包
- 检查方案.md(机读包正式存放;必填依据规范)
来源 docs/core-mechanisms/合规实践检查表转机读包.md
状态:产品决策已确认;技能与打开合规提示安装已落地(2026-08-06);写入目标为「检查方案」(方案 B);平台检查方案主路径 + 问卷改选源 + 存量迁入已落地(2026-08-07)。待做:合规侧独立校验/预览、Excel/Word 体验打磨。
真值:用户可见要求见
docs/产品规格.md§3.2.2 / §3.2.3 / §3.2.4 / §4.2.4。表述:用「内审检查表」「机读包」「检查方案」「规范库」「资料库」「技能」等用户能懂的说法;
mindlink-compliance-pack、plugin_invoke等仅作实现对照。插件 SDK:随发技能约定见
../../sdk/platform-plugin/README.md§7.5。
关联:
- 检查方案.md(机读包正式存放;必填依据规范)
- 规范库.md(条文真源;本流程 依据 之,不把实践包装成法规)
- 资料库.md(专家实践原表存放)
- 工作流与合规.md
../../sdk/platform-plugin/contracts/API.md§3.3(RubricItem/ 加载清单)- 样板:
plugins/compliance/samples/iway6-internal-audit-g1.pack.md
1. 目标
让工作区能把 经验丰富的专业人员制定的实践检查表(Word / Excel / Markdown 等)转成合规可用的 机读标准包,挂进 检查方案 并 依据 规范库条文后,在 调查问卷 中选用并生成检查项——不用实践表或机读包取代官方/客户规范正文。
2. 分工(必守)
| 对象 | 放哪里 | 作用 |
|---|---|---|
| IWAY / 法规等 标准正文 | 规范库 | 「要求是什么」 |
| 专家 内审表 / 项目检查表 原件 | 资料库(类型可用「检查表」;可选「依据」某条规范) | 「怎么查」的原材料 |
机读包(mindlink-compliance-pack) | 检查方案(须依据规范库条目;人审发布) | 驱动生成检查项 |
| 转换方法 | 技能(工作区技能中心) | 教智能体如何映射列 → 包字段 |
| 校验 / 预览 / 写草稿 | 合规插件 受控操作 + 平台写入工具 | 形状校验、预览条数、写入检查方案草稿 |
禁止:
- 用实践机读包 静默替换 规范库中的官方条文真源。
- 把机读包建成规范库里「看起来像法规」的独立条目充当真源(旧路径已废止)。
- 无人确认 即发布检查方案,或直接写入合规检查项业务库。
- 启用合规插件后 静默 给全部智能体绑定该技能(须提示后安装到技能中心,且 不要 按智能体收窄绑定)。
3. 用户流程
资料库上传专家表(或对话附件)
→ 智能体按技能解析并映射为机读包草稿
→ 合规校验/预览检查项条数与样例(待做)
→ 人确认 → 写入「检查方案」草稿(必填依据规范)
→ 检查方案审核发布
→ 合规「调查问卷」选择该已发布方案(展示依据的规范)→ 生成检查项
表中「审核结果 / 发现 / 整改 / 复核」等列属于 工作流执行,不写入机读包。
4. 技能与插件(实现意向)
| 交付 | 说明 |
|---|---|
| 技能包 | 随 plugins/compliance 发版(skills/practice-checklist-to-pack/);安装进 工作区技能中心 |
| 启用合规时 | 提示「安装:实践检查表 → 合规机读包」到技能中心;不要再引导绑到某一只智能体 |
| 技能内容 | 列映射、阶段推断、与 G1 样板对照;交付写入 检查方案草稿(勿用 knowledge_write;勿再把包写成规范库伪法规) |
| 合规操作 | 校验 pack schema、预览将生成的检查项摘要;可选「写入检查方案草稿」(须确认) |
| 技能升级 | 打开合规时比对内嵌包内容指纹;落后则静默升级工作区技能 |
机读包字段与加载清单契约:见 ../../sdk/platform-plugin/contracts/API.md §3.3 与合规 mindlink.compliance.check_pack/v1。
5. 落地顺序
- ~~技能正文 + 样板;打开合规提示安装到技能中心。~~(2026-08-06)
- ~~产品决策更正:机读包进 检查方案,规范库只留条文。~~(2026-08-07,见 检查方案.md)
- ~~检查方案存储 / API / 管理页 / 插件只读。~~(2026-08-07)
- ~~智能体
workspace_check_scheme_write/workspace_check_scheme_list。~~(2026-08-07) - ~~合规问卷优先选「检查方案」(无方案时过渡回退规范库)。~~(2026-08-07)
- ~~存量实践条从规范库迁出(管理页「从规范库迁入」)。~~(2026-08-07)
- 待做:合规侧独立校验 / 预览 pack。
- Excel/Word 一键体验打磨。
说明:「启用」产品口径 = 工作区 打开合规管理(非改 mindlink.json)。
过渡:问卷仍可回退读取规范库中的机读条目,并提示迁入检查方案;不得向用户宣称该条即正式法规。
6. 修订记录
| 日期 | 说明 |
|---|---|
| 2026-08-06 | 初稿:产品决策落地为机制说明;与三库分工、技能安装门控对齐 |
| 2026-08-06 | 首期实现:技能包 + 打开合规提示安装到技能中心(不绑单智能体) |
| 2026-08-06 | 插件 SDK:platform-plugin §7.5 / sdk 契约 §1.3 收录「插件随发技能」做法 |
| 2026-08-06 | 通用 API:…/platform-plugins/{moduleId}/skills 替换合规专用 practice-skill 路由 |
| 2026-08-07 | 智能体系统工具:workspace_standard_list / workspace_standard_write(当时写入规范库草稿) |
| 2026-08-07 | 方案 B:机读包目标改为 检查方案;废止「实践包装成规范库条目」;详稿 检查方案.md |
| 2026-08-07 | 平台主路径落地:检查方案 CRUD/发布门控、智能体写入、问卷优先选方案 |
| 2026-08-07 | 存量迁入:管理页从规范库迁出含机读包条目 |