Skill: evonne528/apple-notes-formatting (version 1.0.0)

--- name: "apple-notes-formatting" description: "Use when the user wants to beautify, restructure, or rewrite content into an Apple Notes-friendly note, especially article summaries, knowledge cards, topic research notes, study notes, or long Chinese notes that need clear Title/Heading/Subheading/Body hierarchy, restrained bolding, semantic highlight colors, and deliberate use of lists, tables, quotes, code style, and note links." --- # Apple Notes Formatting 用于把原始材料、草稿或已有笔记，整理成适合 Apple Notes 长期保存、检索、折叠和复用的格式。 ## 何时使用 - 用户要“改成 Apple Notes 风格”“整理成备忘录格式”“做一版更适合 Apple Notes 的笔记” - 用户想把文章总结、知识卡片、主题研究、课程笔记、会议笔记或零散草稿重排成更清楚的结构 - 用户明确询问 `Title` / `Heading` / `Subheading` / `Body`、加粗、高亮、列表、表格、引用、等宽文本、链接该怎么用 - 用户希望输出“可直接粘贴进 Apple Notes”的笔记草稿，或先要一版带样式标注的排版方案 如果用户没有提供内容材料，就先请对方给出原文、草稿、链接、截图转写内容，或至少说明笔记主题与用途。 ## 默认工作流 1. 先判断笔记类型： - 单篇文章总结 - 长期知识卡片 - 主题研究 / 项目研究 - 其他结构化笔记 2. 为整条笔记确定一个可检索的 `Title`： - 只出现一次 - 放在最上面 - 写成“主题 + 结论 / 对象” 3. 先搭骨架，再写内容： - 需要长期维护或模块较多时，用 `Heading` - 一个模块下存在固定维度时，用 `Subheading` - 其余解释都放 `Body` 4. 处理重点： - 加粗只给必须扫到的结论、关键词、关键判断和动作 - 高亮只表达标签，不表达情绪 5. 选择块级结构： - `Checklist` 用于核对或待办 - `Numbered List` 用于顺序、步骤、因果链 - `Bullet List` 用于并列信息 - `Table` 用于固定字段采集或并列对比 - `Block Quote` 用于保留关键原话 - `Monospaced` 用于代码、命令、API、字段名 - 链接用于把单条笔记接入知识网络 6. 输出前做一次“不过度装饰”检查： - 不堆标题 - 不滥用粗体 - 不滥用颜色 - 不把所有内容都塞进表格 ## 输出方式 默认输出为“Apple Notes 样式标注版”，方便用户直接套用段落样式。使用以下标记： - `[Title]` - `[Heading]` - `[Subheading]` - `[Body]` - `[Highlight: Yellow]` - `[Highlight: Red]` - `[Highlight: Green]` - `[Highlight: Blue]` - `[Checklist]` - `[Numbered List]` - `[Bullet List]` - `[Table]` - `[Quote]` - `[Monospaced]` - `[Link]` 如果用户明确要求“只给可直接粘贴的纯内容”，就去掉这些标签，只保留清晰结构和必要的加粗。 ## 输出要求 - 默认用中文写，语言简洁、判断明确，不写空泛套话 - 不为了“看起来整齐”制造层级；每一层都要有管理价值 - 正文一段只讲一个点；连续 4 到 5 段无层级正文时，主动补结构 - 一屏里通常只保留 1 到 3 个加粗点 - 颜色数量要少，让颜色承担“分类”而不是“装饰” - 引用只保留最关键的一两句，引用下方补一句判断 - 如果内容更适合连续论证，就不要强行改成表格 - 如果未来会继续补资料，优先设计可折叠的 `Heading` / `Subheading` - 如果用户给的是碎片材料，先完成去重、归并、压缩，再排版 ## 常用模板 严格排版时，先读取 [references/apple-notes-style-guide.md](references/apple-notes-style-guide.md)。默认优先使用以下模板之一： 1. 文章总结 - `Title` - `Heading`: 核心问题 / 核心观点 / 关键逻辑 / 我的判断 / 可行动点 2. 知识卡片 - `Title` - `Heading`: 这是什么 / 为什么重要 / 适用边界 / 我的判断 / 相关链接 3. 主题研究 - `Title` - `Heading`: 研究问题 / 现状 / 关键分歧 / 我的判断 / 下一步 / 延伸阅读 ## 质量检查 输出前快速自检： - `Title` 是否具体到能在搜索里一眼看懂 - 长笔记是否用了可折叠的一级模块 - 二级结构是否只出现在可复用维度里 - 是否把加粗控制在真正的重点上 - 是否只给“核心结论 / 风险 / 动作 / 待验证”上色 - 列表、表格、引用、代码样式是否各司其职 - 是否补上了最值得继续追踪的相关链接

path: agents/openai.yaml
content: interface:
  display_name: "Apple Notes Formatting"
  short_description: "Turn drafts into clean, structured Apple Notes"
  default_prompt: "Use $apple-notes-formatting to turn this draft into a clean Apple Notes note."

path: references/apple-notes-style-guide.md
content: # Apple Notes Style Guide

这份参考文档提供 Apple Notes 笔记美化时的细化规则。只要用户要求“严格按 Apple Notes 结构排版”“解释该用什么样式”“把草稿整理成长期可维护笔记”，就按这里执行。

## 核心原则

- `Title` 是整条笔记的文件名级信息，只出现一次
- `Heading` / `Subheading` 用来管理内容，不是装饰
- `Body` 承载解释、展开和补充判断
- 加粗只给必须扫到的内容
- 颜色不是强调器，颜色是分类器
- 列表、表格、引用、等宽文本和链接，只在对应关系成立时使用

## 1. 什么时候用 Title

`Title` 只用一次，只放整篇笔记最上面。

适用：

- 一篇文章一条笔记
- 一条长期知识卡片一条笔记
- 一个主题研究一条笔记

要求：

- 标题写成“主题 + 结论 / 对象”
- 不要写得过泛，比如“读书笔记”“文章总结”
- 最好让人以后在搜索栏里一眼知道这条笔记是干什么的

好例子：

- `为什么大多数总结没有价值：因为只有概述，没有判断`
- `AI Native Hiring Guide 总结：核心不是工具，而是工作方式重构`

不要在正文里重复用大标题冒充 `Title`。

## 2. 什么时候用 Heading

`Heading` 用来切一级模块。

适用场景：

- 一篇笔记内容超过 3 个模块
- 希望后续能快速折叠或展开某部分
- 这篇笔记会被长期维护，而不是看完就丢

推荐一级模块：

- `核心问题`
- `核心观点`
- `关键逻辑`
- `我的判断`
- `可行动点`

以下情况必须使用 `Heading`：

- 内容开始变长
- 一个模块下有多段解释
- 未来可能继续往该模块补内容

## 3. 什么时候用 Subheading

`Subheading` 用来切二级结构。

适用：

- 一个 `Heading` 下面有多个固定维度
- 想让信息结构稳定复用

特别适合总结型写法，例如把一个模块拆成：

- `现状`
- `问题`
- `根因`
- `解决方案`
- `启发`

或者拆成：

- `观点 1`
- `观点 2`
- `观点 3`

判断标准：

- 如果这一层内容未来会反复复用，就用 `Subheading`
- 如果只是临时一句补充，不要上 `Subheading`，直接写正文

## 4. 什么时候只用 Body

`Body` 承载所有普通解释、展开说明和补充信息。

适用内容：

- 概念解释
- 案例描述
- 逻辑展开
- 补充判断

规则：

- 一段正文只讲一个点
- 一段不要太长
- 如果连续出现 4 到 5 段没有层级的正文，说明应该补 `Heading` 或 `Subheading`

## 5. 什么时候加粗

加粗只给“读者必须扫到的东西”。

最适合加粗的只有 4 类：

1. 结论句
2. 关键词 / 方法论名词
3. 转折后的关键判断
4. 行动项里的关键动作

示例：

- `这篇文章真正要解决的不是效率问题，而是协作成本问题。`
- `主线` / `根因` / `行动建议`
- `表面上是在讲工具，本质上是在讲组织如何分工。`
- `先定义问题，再补证据，最后给判断。`

## 6. 什么时候不要加粗

不要这样用：

- 整段都加粗
- 一个自然段里加粗 4 次以上
- 只是因为“我觉得这句很重要”就加粗

判断标准：

- 一屏里最好只有 1 到 3 个加粗点
- 如果重点彼此打架，说明加粗过量

## 7. 什么时候用颜色高亮

颜色高亮只建议承担这 4 个功能：

- 黄色：核心结论 / 必记点
- 红色或粉色：风险 / 反例 / 误区
- 绿色：可执行动作 / 已验证有效的方法
- 蓝色：待验证问题 / 延伸阅读 / 关联线索

适用说明：

- 黄色适合“以后复习只看这些也够了”的句子
- 红色适合常见误解、容易踩坑的地方、需要警惕的判断
- 绿色适合下一步动作、建议保留的做法、可复用框架
- 蓝色适合“我还没想透”的问题、后续要补的资料、可链接到其他笔记的线索

## 8. 什么时候不要上颜色

不要给下面这些上颜色：

- 普通定义
- 普通解释
- 已经加粗过的普通句子
- 只是“看起来顺眼”的内容

颜色一多，信息价值就会迅速下降。

## 9. 什么时候用 Checklist

`Checklist` 适合：

- 待办动作
- 写作检查项
- 复盘核对项

例如：

- 是否说清核心问题
- 是否提炼出核心观点
- 是否保留关键逻辑
- 是否写出文章价值
- 是否给出我的判断

`Checklist` 只用于“要不要做 / 有没有做”，不要拿它写观点总结。

## 10. 什么时候用 Numbered List

适用：

- 有顺序的逻辑
- 操作步骤
- 因果链
- 论证流程

只要顺序不能乱，就用数字列表。

## 11. 什么时候用 Bullet List

适用：

- 平行观点
- 并列事实
- 多个例子
- 多条判断

如果顺序不重要，就不要强行上 `Numbered List`。

## 12. 什么时候用 Table

`Table` 适合：

- 对比两篇文章
- 做“现象 / 问题 / 根因 / 方案”模板
- 记录同一主题下多篇资料
- 统一采集信息

例如：

| 维度 | 内容 |
| --- | --- |
| 主题 | 这篇文章在讲什么 |
| 核心问题 | 作者要解决什么 |
| 核心观点 | 最重要的 1 到 3 条判断 |
| 关键逻辑 | 作者为什么这么说 |
| 我的判断 | 我认可 / 不认可什么 |
| 可行动点 | 对我有什么启发 |

不要用 `Table` 的情况：

- 内容本质上是连续论证
- 需要表达递进关系，而不是并列关系

## 13. 什么时候用 Block Quote

`Block Quote` 适合：

- 原文金句
- 要保留的作者原话
- 访谈、播客、论文的直接摘录

规则：

- 只保留最关键的一两句
- 引用下面最好补一句自己的判断
- 不要整段原文堆进去

## 14. 什么时候用 Monospaced

`Monospaced` 适合：

- 代码
- 命令行
- API 名称
- 字段名
- 需要与正文显著区分的术语

示例：

- `sf project retrieve start`
- `ProcessInstance`
- `External ID`

## 15. 链接怎么用

Apple Notes 支持网页链接，也支持笔记之间互链。

建议：

- 在单篇文章总结里，链接到“母版框架”
- 在主题笔记里，链接到具体单篇文章
- 在“延伸阅读”里，挂网页链接或相关笔记链接

目标是把 Notes 从散乱笔记，逐步变成知识网络。

## 默认输出模板

### 模板 A：文章总结

- `Title`
- `Heading`: 核心问题
- `Heading`: 核心观点
- `Heading`: 关键逻辑
- `Heading`: 我的判断
- `Heading`: 可行动点

### 模板 B：长期知识卡片

- `Title`
- `Heading`: 这是什么
- `Heading`: 为什么重要
- `Heading`: 适用边界
- `Heading`: 我的判断
- `Heading`: 相关链接

### 模板 C：主题研究

- `Title`
- `Heading`: 研究问题
- `Heading`: 现状
- `Heading`: 关键分歧
- `Heading`: 我的判断
- `Heading`: 下一步
- `Heading`: 延伸阅读

## 输出时的最后检查

输出前核对：

- `Title` 是否只出现一次，而且足够具体
- 长内容是否已经拆成可折叠区块
- `Subheading` 是否服务于复用，而不是凑层级
- 加粗是否只留下最值得扫到的地方
- 高亮是否只承担分类任务
- 列表、表格、引用、等宽文本是否都用于正确的关系
- 是否补了必要的判断，而不是只做信息搬运

Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)