semantic-pkm-creator git:20260907.f766f43A

Immutable. This exact content is served forever at /api/v1/blob/4f65b48154c9e7a0.

---
name: semantic-pkm-creator
description: >-
  Extracts callable scenes, concepts, and entities from source text for personal knowledge management in two rounds:
  skeleton with human confirmation, then IPO / decomposition / assembly and relations; concept is the hub.
  Use when 知识萃取、个人知识管理、PKM、semantic-pkm-creator、sce、三层萃取、IPO、场景/概念/实体.
metadata:
  openclaw:
    homepage: https://github.com/ontology-of-everything/SemanticSkills/tree/main/skills/semantic-pkm-creator
---

# 场景-概念-实体萃取（PKM）

## 目标

输入：一批线性原文。输出：用户指定目录下的 `sce-scenes.yaml`、`sce-concepts.yaml`、`sce-entities.yaml`，进度记在 `_sce-round1-progress.md`。价值在调用：一个概念能被另一个场景直接拿来用。三层划分灵感来自「人月聊 IT」《三层架构：场景、概念与实体》。

## 原则

1. **原文至上**：`define` 与 IPO 来自原文，≤50 字；原文写不出就留空，不编造。
2. **概念是中枢**：先立概念，实体挂到概念，场景只调用已成立的概念与实体。
3. **宁缺毋滥**：没有自己的 IPO 或分解，不独立成概念——过虚并入父概念，过碎降为步骤。
4. **引用可控**：每概念 2–6 条关系；同一对知识元只保留最强的一种。
5. **两轮之间必须停下等人确认**；未确认不进入第二轮。

## 流程

**第一轮 · 扫骨架**（每批 5–10 篇，进度写入 `_sce-round1-progress.md`）

1. 读完本批原文，记下进度。
2. 抽候选，只写 `id + define + sources`：场景 = 「如何……」；概念 = 能否 IPO 化；实体 = 「用了 XX 吗」。
3. 全局去重：语义重叠 ≥80% 合并，同义统一 id，过细步骤收回父概念；记合并日志（X→Y）。
4. 写三个 YAML，其余字段标 `TODO`。
5. **停**：出示去重结果与概念覆盖，等确认。

**第二轮 · 填内容**（用 `sources` 回查原文；信号词：先/然后 → 步骤，需要/输入 → IPO 输入）

1. 按中枢填充——先概念（写满 IPO 或分解），实体并行，后场景（触发 + 目标 + 3–6 个递进阶段的组装）。
2. 补关系网：读 `references/relations.md`；实体补层级，概念↔实体用调用。
3. 完整性校验后收口，写 `updated_at`。

## 命题

- 第一轮结束时只有骨架（`id + define + sources`）、无冗余、有合并日志。
- 每个概念有 IPO 或分解之一，没有空壳；每个实体满足「我用了 X」且层级 ≤3；每个场景只调用已成立的概念与实体，3–6 个阶段。
- 所有引用可解析；`define` ≤50 字且有出处；无孤立概念；每概念 2–6 条关系。

## 记法与模板

| 层 | 是什么 | 回答的问题 | 合格定义 |
| --- | --- | --- | --- |
| 概念 | 类 = 可执行动作 | 用什么方法来想 | IPO（输入→处理→输出）保独立逻辑；分解（阶段、子概念、该步为何需要）建调用；可并用 |
| 实体 | 实例 = 可指认对象 | 用什么人 / 工具 / 产品 / 具名框架 | 「我用了 X」且 X 不是动作；有提出者的方法论产品是实体，通用动作是概念 |
| 场景 | 组装 = 问题 + 编排规则 | 如何…… | 触发、目标、3–6 个递进阶段、每阶段调用与约束 |

## 参考

| 何时读 | 文件 |
| --- | --- |
| 第二轮第 2 步：八种关系的方向、何时用、判定顺序 | `references/relations.md` |