# Linkly Notes

> Linkly Notes(笔记)功能的工作流层skill,七模式:闪记(随手记,原话秒存)、显影(模糊记:线索→查证钉出处→纠误差→落成可引用的笔记)、结晶(对话总结:只留结论与拍板)、回响(回顾:旧笔记重浮间隔重复+主题串珠+待办清点;含晨报轻量变体,可挂定时)、寻迹(查笔记)、发芽(tags 自适应初始化:先分类分析再提炼候选交用户拍板)、淬火(思想对撞:新想法拿旧笔记检验,撑你的/打你脸的逐条带出处,agent 只摆证据不当判官)。触发词:记一下、帮我记、记笔记、记一下XX讲的那个故事、帮我找到那句话记下来、把刚才聊的总结记一下、最近记了什么、回顾笔记、来份笔记晨报、找笔记、笔记里搜、盘一下我的标签、用我的笔记挑战一下这个想法、拿笔记跟我抬杠、我记过的东西怎么看这事。存储/索引/检索/元数据全归 Linkly 引擎,skill 只管工作流——永不自建索引、永不写 frontmatt…

- **Type:** Skill
- **Install:** `agentstack add skill-logog782-cmyk-linkly-notes-skill-linkly-notes-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [logog782-cmyk](https://agentstack.voostack.com/s/logog782-cmyk)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [logog782-cmyk](https://github.com/logog782-cmyk)
- **Source:** https://github.com/logog782-cmyk/linkly-notes-skill

## Install

```sh
agentstack add skill-logog782-cmyk-linkly-notes-skill-linkly-notes-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# linkly-notes — Linkly 随手记工作流

本 skill 是 Linkly Notes(时间流笔记)上的**工作流层**:只管记什么、怎么打标、怎么回顾。存储、索引、检索、元数据、版本全部归 Linkly 引擎,agent 不碰。剪藏(Clips)侧的蒸馏/收编/去重归剪藏管家 skill,不归本 skill。

工具通道:优先 CLI `linkly`(已装),MCP 工具(`note_save`/`list`/`search`)兜底。数据位置:`~/LinklyAI/Notes/`,写入只走 `note-save`。

## 模式路由

| 用户说 | 模式 | 动作 |
|---|---|---|
| 记一下 xxx / 帮我记 / 记个想法·待办 | **闪记**(jot) | 一次 note-save,完 |
| 记一下 XX 讲的那个故事 / 帮我找到那句话记下来(给的是线索) | **显影**(模糊记·查证型) | 查证还原→钉出处→纠误差→存笔记 |
| 把刚才聊的总结记一下 / 这段对话沉淀成笔记 | **结晶**(对话总结) | 提炼结论与行动项→存笔记 |
| 最近记了什么 / 回顾一下笔记 | **回响**(review) | 旧笔记重浮+新笔记盘点+串珠+待办清点 |
| 来份笔记晨报 / (定时任务以晨报口径调用) | **回响·晨报**(轻量变体) | 一屏推送:重浮1条+昨日盘点+待办一瞥+串珠预警 |
| 用我的笔记挑战一下XX / 拿笔记跟我抬杠 / 我记过的东西怎么看这事 | **淬火**(quench 思想对撞) | 检索旧笔记→撑你的/打你脸的两列带出处→一个对质问题 |
| 找 xx 的笔记 / 笔记里搜 xx | **寻迹**(find) | search --scope notes |
| 盘一下我的标签 / 标签重新整理 | **发芽**(tags 初始化/重整) | 分类分析→提炼候选→用户拍板 |

## 对外口径

用户要你介绍本 skill 或某个模式时,用下面这套一句话介绍,不现编:

- **闪记**:一闪而过的念头,原话存下——几秒完成,不改写、不追问。
- **显影**:只记得个大概?查证还原、钉死出处、纠正记岔的细节——把模糊印象,显影成一条可直接引用的笔记。
- **结晶**:一场对话,只留结晶——结论、拍板、行动项,不存流水账。
- **回响**:旧笔记定期回来找你——上周的、上月的、更早的,带着问题与你重逢;反复出现的主题串成珠,提醒你动笔。
- **寻迹**:一个关键词,找回当时那条笔记——连原文一起。
- **发芽**:标签不预设,从你的笔记里发芽——先分析存量、提炼候选,你来拍板。
- **淬火**:新想法扔进来,拿你自己写过的笔记淬一遍——撑你的、打你脸的,都是你自己的话;只摆证据,不替你下结论。

## 闪记(jot 随手记)

目标:5 秒内完成一次记录。

1. 取用户**原话**作笔记主体。不改写、不润色、不补充用户没说的内容。
2. 需要场景注记时补一行纯文本,格式 `—— YYYY-MM-DD,场景`,最多一行。
3. 从现役集合挑 1 个类型 tag(命不中→兜底默认`想法`),一次调用写入:

```bash
linkly note-save --mode create --content "内容" --tags 想法
```

4. 回一句确认("记了,打了 X 标签")即止。禁止:先 list 再写、读回验证、展开讨论。

## 显影(模糊记·查证型)

触发判定:用户话里带"找一下/那个故事/那句话/大概是/谁说的来着",或指称有内容缺口。

1. 先查库:`linkly search ""`。命中→以库内原文为准。
2. 库内无→全网检索,出处必须钉齐四要素:人物、时间、刊物/场合、语境。
3. 线索里记岔的名字/细节,以查证结果为准写入笔记,并在回报里说明修正了什么。
4. 笔记内容:中文意译标注"(意译)";引语原文逐字全文附在笔记内;出处写纯文本。tag 从现役集合挑(`金句`/`读书`/`想法`)。
5. 查无可靠出处→**不存笔记**,报告用户并给最接近的候选,等确认。禁止编造出处。
6. 本模式耗时分钟级,不受闪记 5 秒纪律约束。

## 结晶(对话总结)

1. 取材范围:默认=当前对话刚聊完的主题段;用户指定范围按指定。多主题→拆多条笔记,单条笔记单主题。
2. 笔记内只写:结论、关键判断、拍板项、行动项。不写过程复述、寒暄、中间弯路。
3. 用户的关键原话逐字引用;agent 自己的输出只保留被用户认可的结论,压缩表达。
4. 笔记首行 `**主题** —— 与 Agent 对话,YYYY-MM-DD`;tag 从现役集合挑。
5. 存后把笔记内容回显给用户;用户要改→按铁律 3 的 edit 三件套改。
6. 边界:live 对话归本模式;ChatGPT/Claude 等**对话导出文件**的提炼归剪藏管家。

## 回响(review 回顾)

按以下四步执行,顺序固定,产物全部在对话里输出,**不自动存笔记**(用户说"存下来"再存):

1. **旧笔记重浮**(排第一,本模式核心):
   - `linkly list --scope notes --sort recent` 拿全量,按 Created 分三层:8~30 天前 / 31~90 天前 / 90 天以上。
   - 每层随机挑 2 条(层内不足 2 条有几条挑几条;全库总数 <10 条则跳过本步,只做 2~4)。
   - 三层全空(整库最老笔记不足 8 天)→ 本步固定输出一行:"整库最老笔记才 X 天,重浮从第 8 天起有货",然后继续走 2~4,不尬空、不省略本步标题。
   - 每条输出两行:第一行=笔记主题(粗体)+ 创建日期;第二行=一个对质问题,按笔记类型套:`想法`→"这条现在还成立吗?";`待办`→"这件事办了吗,还要不要办?";`金句`/`读书`→"最近有没有场景让你想起它?";`蒸馏`→"当时蒸的这篇,现在有自己的看法了吗?"(用户答了→按剪藏管家的观点层规则追加进该笔记)。
2. **新笔记盘点**:最近 7 天的新笔记,输出数量 + 主题一句话小结。
3. **串珠**:**只聚闪念类笔记**——tag 含`金句`/`蒸馏`/`测试`的资产与测试笔记不参与聚类;同一主题 ≥3 条才成串。每串输出四件:①**串名**(给这组散点命名一个主题短语);②串内笔记标题列表;③一句**共同问题或张力**(这几条都在绕着什么转、哪两条互相打架);④一句**建议落笔角度**。命名和角度是 agent 的活,**正文永不代写**。没有 ≥3 条的主题→输出一行"暂无成串主题"。
4. **待办清点**:tag 含`待办`的笔记逐条列出,每条给用户三选一:已办完 / 升入正经待办系统 / 放弃。用户逐条定;agent 不改任何笔记、不删任何笔记。

时间线一律走 `list`(文件系统扫描,即时);**不要用 search 做回顾**——索引有延迟,新笔记可能搜不到。

### 晨报(回响的轻量变体,可挂定时)

触发:用户说"来份笔记晨报/晨报",或定时任务以该口径调用。**单向推送形态**:一屏读完,不追问、不等回复;全量四步归手动回响。

1. **重浮 1 条**:三层(8~30 / 31~90 / 90+ 天)随机挑一层取 1 条,附对质问题(问题类型表同全量回响);整库不足 8 天→改报最新 1 条笔记 + 一句"重浮从第 8 天起有货"。
2. **昨日盘点**:上次晨报以来(默认近 24h)新笔记 N 条,主题一句话;零新增就写零,不凑。
3. **待办一瞥**:`待办`tag 未清 N 条,点名最老的 1 条;不逐条三选一(那是全量回响的事)。
4. **串珠预警**:有 ≥3 条的主题才提,只报串名一行,展开留给全量回响;没有则整行省略(晨报允许省略小节,不硬凑)。

部署:skill 不含定时器。要每天自动来,部署者自行挂系统定时(cron / launchd 等)调用 agent 说"来份笔记晨报"即可;推送到 IM 的管道同归部署者。

## 寻迹(find 查找)

```bash
linkly search "关键词" --scope notes
```

1. `--scope notes` 时不传 `--library` / `--path-glob`(会被忽略)。
2. 输出:命中笔记的主题 + 相关原文段 + 创建日期。
3. 搜不到且是刚写的笔记→索引延迟,改 `list --sort recent` 按时间找;不要反复重搜。

## 发芽(tags 初始化/重整)

触发:用户说"盘一下我的标签";或 agent 发现 available_tags 基本为空时主动提议(用户点头才跑)。

1. 扫存量:`list --scope notes` 全量笔记 + `explore` 库大盘 + 剪藏标题列表。
2. 聚类:按**类型**(这是什么:闪念/摘录/待办…)×**主题**(关于什么)两个维度,每簇给条数 + 代表例。
3. 提炼候选:类型层 3~6 个(其中指定 1 个兜底默认);主题层按实际簇提,有几个提几个,不硬凑。
4. 候选摆给用户增删拍板;拍板后的集合即现役集合。
5. 重整:用户再次触发→重跑 1~4,输出新旧集合 diff,由用户定。
6. 存量 <20 条不足以聚类→告知用户先裸记(只用兜底 tag),积累后再跑。

## 淬火(quench 思想对撞)

新想法、新决定,扔进旧笔记里淬一遍:撑它的、打它脸的,都是用户自己说过的话。agent 只摆证据、只提问,**不替用户下结论**。

触发判定:用户带着一个想法/决定来对质——"用我的笔记挑战一下XX""拿笔记跟我抬杠""我想XX,我记过的东西怎么看"。(没带新想法、单纯找旧笔记→寻迹;要外部查证→显影。)

1. **钉主张**:把用户的想法压成一句主张先复述(防对错靶子);取 2~4 个关键词含变体。
2. **检索**:`linkly search --scope notes` 逐关键词跑;蒸馏笔记天然在列。命中不足可全库补一轮,引用剪藏内容必须标注"你剪藏过的他人观点",与用户本人的话分开摆。
3. **产出(固定结构)**:
   - 主张一行(粗体);
   - **撑你的**:≤3 条,每条=笔记原话逐字引用 + 创建日期;
   - **打你脸的**:≤3 条,同格式——矛盾可以是直接反对,也可以是"当时的顾虑至今没答案";
   - 收尾**一个**对质问题,指向两列中最尖锐的那对矛盾。
4. 某列空→该列明写"库里没有";两列全空→"这想法在你笔记史上是第一次,没得淬"——也是有效产出。**不硬凑、不用常识编反方**。
5. **零写入**。用户聊完说"把这轮记下来"→转结晶模式存(主题=该主张)。

红线:引用逐字,不裁剪变义;agent 的角色是磨刀石不是判官——证据+提问,判断归用户。

## 铁律

1. **数据层归 Linkly**:永不在 `Notes/` 直接创建/改文件,永不写 YAML frontmatter,永不自建 index/双链/状态机。写入只走 `note-save`。
2. **原话不脑补**:不添加用户/原文没有的内容;引语逐字;意译必须标注并附原文。
3. **tags 纪律**:只从现役集合(available_tags + 用户拍板集)挑;命不中用兜底默认`想法`;用户明说才新增。edit 时 tags 是**全量替换**——先 `list` 拿当前 tags 和 `version`,edit 带 note-id + base-version + tags 三件套;遇 `NOTE_VERSION_CONFLICT` → 重新 list 再试,不许盲写。
4. **内容格式受限**:只支持段落/换行/粗体/删除线/列表;标题、链接、代码、斜体、引用块、表格会被拒——来源一律写纯文本。
5. **无删除**:agent 删不了笔记(产品设计如此);用户要删→告知在 app 里删。

## 版本记录

- v2.5(2026-08-10):新增第七模式**淬火**(思想对撞:旧笔记检验新想法,撑/打两列带出处,agent 只摆证据不当判官);回响加**晨报**轻量变体(一屏四件,可挂定时,定时器与推送管道归部署者);串珠升级(串名+张力+落笔角度,正文仍不代写)。借鉴 Claude × Obsidian 社区 challenge / 晨间摘要 / spark 三类高热工作流,本 skill 红线全数保留。
- v2.4.2(2026-08-08):回响对质问题新增`蒸馏`类——"现在有自己的看法了吗",衔接剪藏管家的观点层(两层蒸馏)。
- v2.4.1(2026-08-08):试用反馈两处修正——重浮三层全空时固定降级话术(整库不足 8 天);串珠排除资产与测试类笔记(tag `金句`/`蒸馏`/`测试`),空串输出"暂无成串主题"。
- v2.4(2026-08-08):按"手册=可执行指令"标准整体重写——结构统一为"路由→对外口径→六模式→铁律",各模式步骤编号量化;新增对外口径节;tags 运行纪律并入铁律;实体表述全文统一为"笔记/条"(弃"卡片")。
- v2.3(2026-08-08):六模式定名(闪记/显影/结晶/回响/寻迹/发芽);回响重设计,旧笔记重浮为核心,步骤量化。
- v2.2(2026-08-08):新增结晶(对话总结)。
- v2.1(2026-08-08):新增显影(模糊记·查证型)。
- v2.0(2026-08-07):重定位为纯 Notes 工作流;tags 改自适应初始化;剪藏侧职能移交剪藏管家。
- v1.0(2026-08-06):初版。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [logog782-cmyk](https://github.com/logog782-cmyk)
- **Source:** [logog782-cmyk/linkly-notes-skill](https://github.com/logog782-cmyk/linkly-notes-skill)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-logog782-cmyk-linkly-notes-skill-linkly-notes-skill
- Seller: https://agentstack.voostack.com/s/logog782-cmyk
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.