agentskill-akasha-kt

name: AgentSkill-Akasha-KT description: 阿卡西记录 - 结构化知识库 Skill，用于保存可复用的技术经验和系统性知识。通过自然语言触发（如"帮我找下..."、"记一下..."、"记得...吗"、"验证下..."），完成经验的【查找】、结论的【记录】以及内容的【维护】。 license: MIT

Akasha-KT 阿卡西记录

目录结构说明

本技能的所有文件均位于 SKILL.md 所在的同级目录 下，结构如下：

<技能根目录>/          ← SKILL.md 所在位置
├── SKILL.md           ← 当前文件（技能定义）
├── data/              ← 所有记录，扁平存放（无子目录）
│   ├── xxx.md
│   └── ...
├── assets/            ← 记录关联的资源文件（图片等）
│   ├── <record-name>/ ← 以记录文件名（去 .md）为目录名
│   │   ├── 01-xxx.png
│   │   └── ...
│   ├── archives/       ← 归档的非 data 层资料（如历史文档）
│   │   └── ...
│   └── ...
└── references/        ← 参考文档（模板、索引、操作指南）

重要：所有路径均为 相对于 SKILL.md 所在目录 的相对路径，与用户工作区无关。

三层边界模型（必须区分）

• 数据层（用户知识）：data/*.md 与配套 assets/<record-name>/*，用于正式记录与资源承载；这是查找/引用/展示给用户的唯一知识来源。
• 索引层（运行依赖）：references/INDEX.md、references/tag-registry.md，用于索引、标签注册和 Web 侧派生数据同步；不作为用户知识查询结果直接返回。
• 系统层（操作规范）：SKILL.md 与 references/workflows/*、references/templates/*、references/scripts/*，仅用于指导 AI 如何执行流程，不可作为用户知识查询结果直接返回。

⛔ 不可违反的执行规则

0. 查询与记录行为分离：
   • 查询（自动执行）：当用户提及过去的问题、经验、方案等，自动激活本技能进行检索，无需用户显式要求。
   • 记录（必须询问）：当认为当前对话内容值得记录时，必须先向用户展示拟记录内容的摘要并征求确认，用户同意后方可执行记录流程。禁止未经确认自行记录。
1. 必须先读流程再执行：收到用户请求后，必须先识别意图并读取对应 workflow 文件，禁止凭记忆直接执行。
2. 查找禁止直接凭记忆回答：必须先在 data/ 目录下执行本地检索（使用 AI 可用的文件搜索/文本搜索工具）；若本地未命中，必须先明确告知“阿卡西本地未命中”，只有在用户明确要求继续调研或意图本身包含外部调研时才进入网络搜索。
3. 记录/更新必须走完整闭环：git pull（执行前）→ 验证检查 → 写入 data/ → 更新 INDEX.md → git commit && git push（执行后）。
4. 索引维护是完成条件：新增或修改记录后，未更新 references/INDEX.md 视为任务未完成。
5. 写入前必须验证：新记录写入或旧记录更新前，必须执行重复检测与正确性检查。
6. 查找结果来源必须是数据层：用户发起知识查询时，只能返回 data/*.md 中的记录内容；禁止把 SKILL.md、references/workflows/*、references/templates/*、references/scripts/* 的内容当作查询结果返回。
7. 查找采用白名单：可搜索并可返回的路径只有 data/*.md。对其他路径即使命中，也必须按“本地未命中”处理，不得直接返回。
8. 正式记录禁止临时态：阿卡西正式库不允许草稿态、半结构态、临时占位态或任何会破坏既有 Web 契约的快捷落库方案；写入 data/ 的内容必须是符合模板的正式记录。
9. 系统规则变更必须走治理流程：凡涉及模板、workflow、索引规则、标签注册规则、字段 schema 或其他 Web 契约的调整，必须走 workflows/governance.md，不得混入普通记录或验证流程处理。

核心规则

分类方式：所有记录通过标签分类，不使用目录层级。

标签要求：每条记录至少 2 个标签，所有标签同级、不分类。新增标签前先查阅 INDEX.md 标签概览，优先复用已有标签。

写入位置：所有记录 → data/*.md

文件命名：kebab-case，自解释，如 urp-renderer-feature-custom.md、csharp-async-pitfalls.md

权限与用途：

索引维护：新增或修改记录时，同步更新 references/INDEX.md 的文件清单（如有新标签则同步更新标签概览）

禁止：在 data/ 外创建数据文件 | 在 data/ 下创建子目录 | 自定义格式 | 操作技能目录外文件 | 在记录中使用绝对路径

❌ 典型错误（禁止模仿）

• ❌ 用户说“记一下”后直接写文件，跳过 git pull、验证检查、索引更新与提交推送。
• ❌ 用户问“之前有没有做过”时直接基于记忆回答，不执行本地检索流程。
• ❌ 本地未命中后直接把外部调研结果包装成“阿卡西里已有结论”。
• ❌ 使用旧目录结构（如 data/experiences/）或在 data/ 外写记录。
• ❌ 修改记录后未同步 references/INDEX.md，却对用户宣称“已完成”。
• ❌ 将 references/ 中的系统操作规范（流程、模板、脚本说明）当作用户知识查询结果返回。
• ❌ 为了快捷记录在 data/ 中写入临时文件、待整理片段或非正式结构内容。

意图识别与路由

当收到用户指令时，必须先基于语义理解（而非仅限关键词匹配）识别用户意图。识别时需兼容各类自然语言变体（如口语、模糊描述），并且必须先读取对应的操作流程文件后再执行操作。若意图为“查找”，返回内容必须来自 data/*.md：

辅助资源：

• 需检索 data/*.md 记录：使用 AI 可用的文件搜索/文本搜索工具，并将范围限定在 data/
• 禁止将 references/INDEX.md 全文作为检索上下文直接发送给大模型
• 需获取记录模板：templates/record-template.md
• 涉及系统层规则变更：先读取 workflows/governance.md
• 涉及结构校验或索引同步：必须遵循 scripts/README.md 并使用对应脚本；禁止退回到人工逐条比对作为主流程。

记录格式

完整模板：references/templates/record-template.md

简要格式

## [标题]
标签 | 来源/收录/更新日期 | 状态 | 可信度 | 适用版本
概要 → 内容 → 关键代码 → 参考链接 → 相关记录 → 验证记录

相互引用

记录之间使用同级相对路径引用：

### 相关记录
- [相关记录标题](./other-record.md) - 关联说明

资源引用

当记录包含图片等资源文件时，存放在 assets/<record-name>/ 目录下，在 md 中使用相对路径引用：

![图片描述](../assets/<record-name>/01-image-name.png)

• 目录名：与记录文件名一致（去掉 .md 后缀）
• 文件命名：序号-描述.扩展名，如 01-retarget-concept.png
• 禁止绝对路径：所有引用必须使用相对路径，不得出现本机绝对路径
• 适用场景：外部文章抓取的配图、技术示意图、UI 截图等需要离线保存的资源

时间字段

状态标记速查