全部文档

检查方案(实践机读包)

- 产品规格.md §3.2.2 规范库、§3.2.3 资料库、§3.2.4 检查方案、§4.2.4 合规

来源 docs/core-mechanisms/检查方案.md

状态:产品决策已确认(2026-08-07,方案 B);平台主路径已落地(存储 / 管理页 / 插件只读 / 智能体写入草稿 / 问卷改选源 / 存量迁入);答疑注入边界仍见验收清单。

真值:用户可见要求见 docs/产品规格.md §3.2.4(及 §3.2.2 / §3.2.3 / §4.2.4)。

表述:界面与帮助用「检查方案」「依据规范」「已发布」等用户表达;表名、API、路径仅在本文 §7 给出。

关联


1. 目标

  • 工作区 内提供与规范库、资料库并列的 「检查方案」:存放专家把法规/制度 操作化 后的 机读检查包(用户说法;实现上含 mindlink-compliance-pack 等)。
  • 合规调查问卷 选用并生成检查项;日后可扩展至 HR 等「标准包」类机读内容(首期以合规为主)。
  • 必须标明依据哪几条 规范库已发布 条目;禁止把检查方案当成法规条文本身。

1.1 非目标

  • 不替代规范库条文真源;不替代资料库里的 Excel/Word 原件。
  • 不把检查方案默认注入智能体答疑当作「法规怎么说」。
  • 首期不做全站公有「方案市场」(工作区隔离)。

2. 与相邻能力的分工

| | 规范库 | 检查方案 | 资料库 | 知识文档 | |--|-----------|-------------|-----------|-------------| | 用户一句话 | 要遵守什么 | 专家建议怎么查 | 原件与空白表 | 怎么用、FAQ | | 典型内容 | 法规/制度/理论正文 | 机读检查包 Markdown | xlsx/docx 检查表原件 | Wiki | | 效力 | 真源 | 操作化(须依据真源) | 原材料 / 套用 | 说明 | | 驱动检查项 | 否(只作依据展示) | (问卷选用) | 否 | 否 | | 答疑注入 | 已发布条文 | 默认不注入为法规 | 元数据可选 | 是 |

规范库(条文怎么说)
    ↑ 必填依据
检查方案(怎么查 · 机读包)
    ↑ 可选来源
资料库(专家表原件 / 空白表)

3. 产品决策(已确认,2026-08-07)

#主题结论
1用户可见名称检查方案(副题可用「实践机读包」)
2隔离边界按工作区;禁止跨工作区读
3存放位置平台工作区能力,不挂在某一插件私有目录
4与规范库分治;方案 必填 依据规范(ID + 发布版本,可多条);无依据 不得发布
5与资料库原件在资料库;转换结果进本能力,在资料库存机读包真源
6与知识文档分治;禁止把机读包主存放进知识目录
7发布门控草稿 → 待审(可选)→ 已发布 / 已废止;与规范库同级:管理员发布
8智能体写入系统工具写入 草稿(须用户确认);禁止自动发布;禁止再用规范库条目冒充检查方案
9插件读取经平台只读 API;合规问卷 优先选已发布检查方案(展示依据规范);也可选尚无检查方案的规范(按正文粗拆,须人审)
10落库审计生成检查项时记录 方案 ID + 版本 以及 依据规范 ID + 版本
11管理入口协作页与规范库/资料库并列;全屏管理(建议路由 /workspace/check-schemes
12存量迁移已误作「规范」发布的纯实践包 → 迁入本能力并补依据;规范库仅保留真正条文
13HR 扩展胜任力等机读「标准包」可二期并入本模型;首期不做强制迁移

禁止

  • 用检查方案静默替换规范库条文。
  • 无人确认即发布方案,或直接写入合规检查项业务库。
  • 问卷界面只写「对照法规」却不展示依据规范。
  • 将检查方案写入知识文档或规范库正文当作法规真源。

4. 用户可见能力

4.1 方案条目

  • 标题、短说明
  • 机读正文(Markdown;含合规机读围栏等)
  • 领域标签(如 compliance
  • 依据规范(必填,可多条:规范 ID + 版本;发布时校验目标仍为已发布且未废止)
  • 可选来源资料(资料库条目 ID + 版本)
  • 状态版本、创建者、时间

4.2 成员与管理员

  • 成员:浏览已发布方案;可创建/编辑 自己的草稿(或按工作区策略)。
  • 管理员:审核发布、废止、处理他人草稿;导入 / 导出 压缩包。

4.3 智能体与插件

  • 智能体:技能转换后调用写入工具落 草稿;成功后引导用户到「管理检查方案」发布。
  • 合规插件:列表/读取已发布方案 → 问卷选用 → 预览生成检查项 → 人确认后写业务库。

5. 端到端流程

路径 A(实践表):
资料库上传专家检查表(可选依据规范)
  → 智能体按技能解析为机读包
  → 人确认 → 写入「检查方案」草稿(带依据规范)

路径 B(依据规范粗拆):
规范库已发布条文 → workspace_standard_get 读正文
  → 按条款粗拆机读包(须标明人工补全 evidence/评分)
  → 人确认 → 写入「检查方案」草稿(based_on_standards 指向该规范)

共用后续:
  → 管理员发布检查方案
  → 合规「调查问卷」选择该方案(展示依据的规范)
  → 生成检查项(记录方案版本 + 规范版本)

表中「审核结果 / 发现 / 整改 / 复核」等列属于 工作流执行写入机读包。


6. 与旧决策的关系

  • 2026-08-06 曾约定:机读包进 规范库(同条或单独实践条目)。
  • 2026-08-07 更正为方案 B:机读包进 检查方案;规范库只保留条文真源。
  • 过渡期:问卷仍可回退读取规范库中的机读条目,并提示迁入检查方案;产品文案与技能以本文为准。

7. 实现对照(已落地)

概念实现
元数据表workspace_check_schemes
依据关联based_on_standards_json(standard_id + version)
正文落盘{RuntimeDir}/workspaces/{ws}/check-schemes/{id}/draft.mdvN.md
成员 API/workspaces/{id}/check-schemes(含 content / publish / revoke / reopen / delete);导入/导出 POST …/check-schemes/importGET …/check-schemes/export(zip)
插件只读/platform-plugins/check-schemes(仅已发布)
智能体工具workspace_check_scheme_list / workspace_check_scheme_write(confirm 门控);依据规范时用 workspace_standard_get 读正文
管理页/workspace/check-schemes;协作入口「管理检查方案」
问卷检查方案与规范库并列可选(方案优先);无方案的规范按正文粗拆
存量迁入GET …/migration-candidatesPOST …/migrate-from-standard;管理页「从规范库迁入」
发布权限仅工作区 owner/admin 可 publish / revoke / reopen;导入/导出压缩包 同此权限
压缩包manifest.jsonkind=mindlink.workspace_check_schemes)+ `items/{dir}/item.jsoncontent.md(包 internal/checkschemesbundle)。增量导入(默认 on_conflict=incremental`):按 标题 匹配;内容哈希相同则跳过;匹配到草稿/待审则更新;已发布/已废止不覆盖。依据规范按 文号优先、否则标题 挂回本工作区已有条目(优先已发布);未匹配则仍导入为草稿,发布前须补挂。可选按标题弱关联来源资料。

机读包字段契约仍见 ../../sdk/platform-plugin/contracts/API.md §3.3 与合规 mindlink.compliance.check_pack/v1


8. 验收要点

  • [x] 无「依据规范」无法发布检查方案。
  • [x] 规范库含机读包的实践条可迁入检查方案(迁入后废止/删除原条)。
  • [ ] 答疑注入不含检查方案正文冒充条文(系统提示已引导;检索注入边界待补强)。
  • [x] 问卷优先选方案并展示依据规范;解析正文优先读检查方案。
  • [x] 智能体写入仅草稿;须确认;不自动发布。
  • [x] 存量实践包从规范库迁入检查方案(管理员手动确认)。
  • [x] 管理员可导入/导出检查方案压缩包(增量;已发布不覆盖)。

9. 修订记录

日期说明
2026-08-07初稿:方案 B 升为产品决策;与规范库/资料库分治;替代「机读包进规范库」旧路径
2026-08-07平台主路径落地:表/API/管理页/智能体工具/问卷改选源;更新实现对照与验收勾选
2026-08-07存量迁入:管理页「从规范库迁入」+ migration-candidates / migrate-from-standard
2026-08-18压缩包导入/导出(仿规范库;管理员;导入为草稿;依据规范按标题/文号挂回)