SuperAPI AI 工具集

epistemic-mapper

办公与效率

查看项目

更新于 10-15 21:54

技能介绍

用途:在原型交接、团队接手或合同签署后,把散落在文档与代码中的隐性知识显性化,生成一份规范化的 EPISTEMIC-MAP.md,作为交接产物。

主要能力:按四象限分类知识——已验证事实(Known Known)、开放问题(Known Unknown)、未记录假设(Unknown Known)、风险(Unknown Unknown)。事实、问题、假设由子代理逐源提取,风险则在合并后对整体做一次综合判断,因为单一来源无法识别系统性风险。合并脚本负责 ID 分配、类别规范化、跨源去重与排序,并自动生成 3-5 条按象限与严重度排序的 Epistemic Backlog。

使用方式:先读取已有的 CONSTRAINTS.md、JARGON.md、ARCHITECTURE.md、AGENTS.md 作为交叉引用与置信度种子;自动扫描 docs/、README.md 等文档目录及主要代码模块,排除 openspec/changes/archive/ 与上述活文档本身。每个来源派发一个子代理,每波最多 5 个并发,子代理将草稿写入绝对路径(如 /tmp/epistemic-mapper/<source-id>.json)。随后用单次调用合并:python3 scripts/merge_epistemic_map.py --findings /tmp/epistemic-mapper/doc-1.json ... --output-dir /absolute/path/to/repo/root。可选 --interview 在合并后启用简短访谈。

限制:不得自创类别 slug,只能使用五个规范 slug;不得凭记忆改写 schema 字段名或象限值;不得创建独立状态文件或中间合并文件;不得截断、摘要或写占位符;不得手工编辑 EPISTEMIC-MAP.md;不得添加“Related Documentation”章节;草稿必须用绝对路径;不得自动爬取 openspec/changes/archive/;无证据不得编造条目,不确定应标 INFERRED。该文件应随验证推进而收缩,未解决项数量不降反升说明交接未真正推进。