检查方案(实践机读包)
- 产品规格.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 给出。
关联:
- 产品规格.md §3.2.2 规范库、§3.2.3 资料库、§3.2.4 检查方案、§4.2.4 合规
- 规范库.md(条文真源;本能力 依据 之,不取代)
- 资料库.md(专家表原件、空白检查表)
- 合规实践检查表转机读包.md(专家表 → 机读包 → 本能力)
- 工作流与合规.md
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 | 存量迁移 | 已误作「规范」发布的纯实践包 → 迁入本能力并补依据;规范库仅保留真正条文 |
| 13 | HR 扩展 | 胜任力等机读「标准包」可二期并入本模型;首期不做强制迁移 |
禁止:
- 用检查方案静默替换规范库条文。
- 无人确认即发布方案,或直接写入合规检查项业务库。
- 问卷界面只写「对照法规」却不展示依据规范。
- 将检查方案写入知识文档或规范库正文当作法规真源。
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.md 与 vN.md | |
| 成员 API | /workspaces/{id}/check-schemes(含 content / publish / revoke / reopen / delete);导入/导出 POST …/check-schemes/import、GET …/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-candidates、POST …/migrate-from-standard;管理页「从规范库迁入」 | |
| 发布权限 | 仅工作区 owner/admin 可 publish / revoke / reopen;导入/导出压缩包 同此权限 | |
| 压缩包 | manifest.json(kind=mindlink.workspace_check_schemes)+ `items/{dir}/item.json | content.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 | 压缩包导入/导出(仿规范库;管理员;导入为草稿;依据规范按标题/文号挂回) |