| name | ah-card |
| description | 卢曼卡片笔记法制卡引导。自动识别输入源类型（收藏文章/文献笔记/用户笔记），分流到对应制卡路径。收藏文章先引导思考方向再多卡产出；文献笔记基于已有洞见直接制卡；用户笔记从零散记录中提炼制卡。所有路径共享深度充足性闸门、用户原话优先、分层关联与同步规则。 |
执行 Obsidian 的读取、检索、写入等动作时，优先调用官方技能：obsidian-cli。
永久笔记制作引导技能
目标：严格按卢曼卡片笔记法制卡，确保"用自己的话表达 + 一卡一事 + 高质量连接"。
第一步：输入源判定与分流
启动后立即执行：
- 读取
{{metaPaths.memory}}/STATUS.md 检查待制卡事项。
- 分析用户输入，判定输入源类型。
- 按判定结果分流到对应路径。
判定规则
| 输入源 | 判定特征 | 分流路径 |
|---|
| 收藏文章 | 篇幅较长、结构完整（有标题/段落/论述）；内容非用户原创（他人文章风格）；用户未附带自己的观点 | → 路径 A |
| 文献笔记 | 来自 {{notePaths.literatureNotes}}/ 的文件；由 ah-read 产出；包含已提取的洞见条目 | → 路径 B |
| 用户笔记 | 来自每日记录、回顾思考、inbox 整理等；内容是用户自己的零散想法或记录 | → 路径 C |
判定优先级：先检查是否为文献笔记（路径明确），再检查是否为收藏文章（内容特征），其余归为用户笔记。
用户也可以主动声明来源（如"这是我收藏的一篇文章"），以声明为准。
路径 A：收藏文章 → 思考引导 → 多卡产出
详细规则：references/article-to-cards-guide.md
核心理念：文章是思考的触发器，不是笔记的内容来源。卡片记录的是用户自己的思考。
流程概览（4 阶段）：
- 文章解析与思考方向推荐 — 提取核心论点，推荐 3-6 个思考方向，用户选择或自定义。
- 逐方向引导思考 — 每个方向通过引导问题帮用户形成自己的观点，无法展开的方向可跳过。
- 卡片规划与确认 — 汇总思考结果，规划卡片列表（断言式标题草案），用户确认增减。
- 逐张制卡 — 按确认列表逐张进入共享制卡流程（深度闸门 → 成稿 → 关联 → 保存）。
路径 B：文献笔记 → 洞见提取 → 制卡
详细规则：references/literature-note-cards-guide.md
核心理念：文献笔记已经过 ah-read 整理，包含结构化的洞见条目，制卡聚焦于将洞见转化为用户自己的永久笔记。
流程概览（3 阶段）：
- 洞见扫描与候选提取 — 读取文献笔记，提取已标记的洞见条目，列出候选，用户选择要制卡的洞见。
- 逐条深度判定与补充 — 对每条候选进入深度充足性闸门，不足则引导补充。
- 逐张制卡 — 进入共享制卡流程，来源链接到对应文献笔记。
路径 C：用户笔记 → 提炼 → 制卡
详细规则：references/user-note-cards-guide.md
核心理念：用户的零散记录中蕴含值得沉淀的想法，帮助用户识别并提炼出可制卡的观点。
流程概览（3 阶段）：
- 内容扫描与观点识别 — 阅读用户的记录内容，识别出可独立成卡的观点或想法，列出候选。
- 逐条深度判定与补充 — 对每条候选进入深度充足性闸门，不足则引导补充。
- 逐张制卡 — 进入共享制卡流程，来源标注为每日记录或对应笔记。
共享规则（所有路径通用）
以下规则适用于所有路径的制卡环节，详细规则见对应的 references 文件。
深度充足性闸门
每张候选卡片必须先过闸门，检查三项：
- 观点是否明确（不是模糊话题）
- 是否解释了"为什么成立"
- 是否给出边界/条件/场景中的至少一项
判定：>= 2 项满足 → 可制卡；< 2 项 → 深度不足，先引导再制卡。
深度不足时：告知不足点 → 调用 /ah-think 引导 → 收集补充后重新判定。
用户原话优先（硬约束）
- 标题、核心观点、正文、应用场景均优先使用用户原话。
- 若内容缺失，标记"待用户补充"，禁止 AI 自动补写完整段落。
- AI 可做的仅限：结构重排、重复合并、语义澄清提问。
制卡步骤
- 断言式标题（完整陈述句，表达明确观点）
- 核心观点（一句话概括）
- 详细说明（为什么成立 + 具体实现 + 边界与适用条件）
- 关联发现（分层读取）
- 用户确认后保存至
{{notePaths.permanentNotes}}/{{标题}}.md
- 同步更新：主题笔记、来源笔记、反向链接
- 输出结果汇总
关联发现规则（分层读取）
按顺序执行，禁止全量扫描：
- 读取主题笔记标题（
{{notePaths.topicNotes}}/）
- 读取领域页标题（
{{notePaths.domainPages}}/）
- 选择 1-3 个候选主题/领域
- 定向读取主题笔记，提取已链接笔记标题
- 定向读取候选笔记内容，确认关联关系
流程锁定规则
- 制卡过程中提到"阅读/项目/回顾"等词，默认视为当前制卡输入，不自动切技能。
- 仅在用户明确输入其他命令（如
/ah-read）或明确要求停止时才允许切换。
- 流程完成标志：卡片保存完成 + 关联更新完成 + 已输出汇总。
重要提醒
- 禁止使用示例数据，所有内容必须来自用户真实输入与真实文件。
- 禁止 AI 代写用户观点。
- 未经用户确认，不写入争议链接或猜测性结论。
输出标准
- 必须输出：新建卡片、关联关系、主题笔记更新、来源笔记更新、反向链接更新。
- 每条更新标注具体路径，确保可追溯。
- 有待确认项时明确标记"待确认"，不静默落盘。
检查清单
渐进加载（按需读取）
- 卡片方法与质量标准：
references/zettelkasten-principles.md
- 永久笔记输出模板：
references/card-template.md
- 链接格式规范：
references/链接规范.md
- 共享制卡与同步规则：
references/workflow-and-sync-rules.md
- 路径 A 收藏文章制卡：
references/article-to-cards-guide.md
- 路径 B 文献笔记制卡：
references/literature-note-cards-guide.md
- 路径 C 用户笔记制卡：
references/user-note-cards-guide.md
相关技能
ah-think：深度引导（深度不足时调用）ah-read：阅读整理，产出文献笔记后可进入路径 Bah-inbox：批量整理记录后可进入路径 Cah-review：晚间回顾中识别可制卡内容，可进入路径 C
