关联主题:: Skills索引
同级::
下一级::

002｜Skills智能归档 Skill

一句话说明

“Skills智能归档”把一次 Skill 安装或创建，整理成一套可查、可复用、可审计的记录：核验真实文件，统一身份和开源类型，分配永久编号，建立独立说明页，更新 Skills索引，并按需要同步 Canvas、JSON 和日志。

本页边界

本 Skill 管理的是 Skill 的生命周期记录，不负责替代具体业务 Skill。原有 skills归档 仍专注 Canvas 视觉节点；本 Skill 负责完整的知识登记和状态复核。

1. 基本信息

字段	内容
Skill 编号	002
展示名称	Skills智能归档
英文名称	Skills Intelligent Archive
功能定位	管理 Skill 的身份、说明、索引、来源、类型和审计记录
适用平台/场景	苏苏 Obsidian 知识库中的 Skill 安装、创建、导入、更新、替换、改名和停用归档
类型	不开源
许可证	内部流程
当前状态	已安装
命令别名	自然语言触发；可与 skills归档 配合
来源	苏苏知识库内部流程
关联入口	Skills索引

2. 为什么需要它

单独把 SKILL.md 放进目录，只能说明“这个 Skill 能做什么”；长期维护还需要回答：它叫什么、什么时候安装、是否有上游、是否开源、适合处理什么场景、是否已经登记、说明页在哪里、两个运行环境是否一致，以及这次变化有没有留下记录。

因此，本 Skill 把 Skill 信息分成两层：

• 执行层：.agents/skills/ 和 .claude/skills/ 中真正被 Agent 读取的 SKILL.md 与脚本。
• 知识层：Skills索引、AI/Skills/ 下的独立说明页、Canvas 节点、索引 JSON、运行档案和日报日志。

执行层决定 Skill 怎么工作，知识层保证它以后能被找到、比较、追溯和复用。

3. 标准工作流程

3.1 发现真实状态

先读取仓库 AGENTS.md 和当前时间，再用 rg --files 检查 .agents/skills/、.claude/skills/ 中真实存在的 SKILL.md。同时读取 frontmatter、README、LICENSE、安装脚本和关键功能代码，区分当前活动副本、兼容副本、历史目录和运行产物。

如果用户提供外部项目链接，先完成 Agent-Reach 的状态检查，再读取公开来源；不自动读取 Cookie、Token 或其他凭据。

3.2 统一身份与类型

记录展示名称、英文名称、技术目录、功能定位、适用平台/场景、来源、许可证和当前状态。名称改了不代表一定是新 Skill；先按技术目录、英文名、别名和来源查重。

类型只使用以下三个值：

• 开源：有公开源代码和许可证，本地未改变功能代码。
• 不开源：没有可核验的公开源代码/许可证，或是知识库内部创建的流程。
• 开源基础之上魔改：基于开源项目且本地修改了功能代码、依赖、处理逻辑或输出行为。

仅修改展示名称、路径、说明、索引或日志，不算“魔改”。不能因为项目托管在 GitHub 就直接标记为开源。

3.3 分配永久编号

已存在的 Skill 改名、移动、替换实现或从评估转为已安装时，沿用原编号。真正的新 Skill 才从 Skills索引 的最大编号加一，使用 001、002、003 的格式；编号一经分配不再复用。

本 Skill 的编号是 002，与 80 知识索引/概念索引.md 的概念编号相互独立。

3.4 建立独立说明页

每个已安装 Skill 在 Obsidian blog/content/1 Article/AI/Skills/ 下对应一篇说明页。说明页保留稳定的博客 frontmatter 和唯一的全小写 kebab-case slug，并在 frontmatter 之后固定放置：

关联主题:: [[Obsidian blog/content/0 知识索引🌳/Skills索引|Skills索引]]
同级::
下一级::

可见基本信息表至少包含：功能定位、适用平台/场景、类型、许可证、当前状态和来源。技术目录、主路径、Claude 兼容路径保留在 frontmatter 或正文追溯区，不放进可见表格，避免表格被实现细节挤满。

3.5 更新 Skills索引

Skills索引是统一导航，固定使用以下列：

| 序号 | Skill | 英文名称 | 功能定位 | 适用平台/场景 | 类型 | 上游来源 | 独立说明 |
| --- | --- | --- | --- | --- | --- | --- | --- |

每个 Skill 只登记一行；.agents 与 .claude 两个副本不重复占号。功能定位回答“它做什么”，适用平台/场景回答“在哪里用”，类型回答“它的开源来源状态”。

3.6 同步 Canvas 与 JSON

如果用户要求可视化归档，调用或复用 skills归档 的 Canvas 规则：选择最贴切的分类、查重节点、更新 Claude Skills.canvas，并同步 references/skills-index.json 的已安装清单和相关计数。只修改相关条目，不覆盖其他 Skill 的用户改动。

如果本轮只需要说明页和 Skills索引，可以不强制创建 Canvas 节点，但完成报告必须说明是否同步。

3.7 写入审计记录

每次归档都在 .kb/logs/skill-archive/YYYY-MM-DD_HHmm_<模式>.md 建立独立运行档案，并按仓库规则同步当天日报和 80 知识索引/AI自动知识管理更新日志.md。记录真实路径、来源证据、类型判断、修改文件、验证结果和未决问题，不写入秘密。

4. 与概念卡流程的关系

登记 Skill 不等于创建一个新的“Skill”概念卡。先查重并复用已有 028｜Skill（AI技能）；只有当用户确认新概念名称和边界，或材料形成稳定且跨笔记复用的独立概念时，才进入概念卡智能归档流程。

创建或更新博客说明页时，仍需完成仓库要求的 RNKP/INKP → 概念卡智能归档 → 知识索引路由评估；SKILL.md、运行档案、索引 JSON 和日志属于配置/审计文件，不递归触发同一正文流程。

5. 质量检查

交付前检查：

• 主 Skill 与兼容副本是否存在，核心内容是否按约定同步。
• 编号、展示名称、英文名称、来源和安装状态是否与真实文件一致。
• 说明页是否有唯一 slug、三个关系字段，以及指向 Skills索引的 关联主题。
• 说明页与 Skills索引是否都有功能定位、适用平台/场景和合法的三值类型。
• 可见表格是否没有技术目录、主路径和 Claude 兼容路径列。
• Canvas/JSON 如有同步是否仍是有效 JSON、无重复节点且未破坏旧记录。
• 运行档案、日报和 AI 管理日志是否已经写入。

6. 与其他 Skill 的协作

Skill	分工
skill-creator	创建或迭代 Skill 的说明规范、测试和打包
Skills智能归档	统一身份、编号、独立说明页、Skills索引、类型和审计
skills归档	Canvas 视觉分类和节点维护
概念卡智能归档	概念查重、概念卡创建/更新及 CFlow/Obsidian 内容路由
知识索引	概念和知识入口的长期索引维护

7. 来源与关联

• Skills索引
• 001｜逐字稿 Skill（Transcript）
• 如何准确地调用 Skills？
• Skill（AI技能）
• skills归档
• skill-creator

文档更新日志

• 2026.08.28｜建立 002 说明页：把已确认的 Skill 登记、独立说明、类型判定、索引同步和审计流程封装为“Skills智能归档”。