SuperAPI AI 工具集

Org Ecosystem

写作与研究

查看项目

更新于 10-16 05:58

技能介绍

用途

Org Ecosystem 是一个面向 Emacs Org-mode 的技能,当用户提出编写 org 文件、使用 org-mode、org 语法、org 文档、org babel、org 导出等需求时使用。它围绕 Org 生态提供语法参考、工作流配置和导出方案。

主要能力

Org 语法

  • 层级大纲结构:使用星号表示不同层级标题。
  • 属性(properties):附加到标题的键值元数据,例如 :CATEGORY:、:EFFORT:。
  • 抽屉(drawers):隐藏内容块,例如 :LOGBOOK: 中记录 CLOCK 时间。
  • 时间戳:支持活动时间戳、非活动时间戳、带时间、重复(+1w)、从完成重启(.+1d)等形式,并提供时间戳类型选择决策树。
  • 表格:类似电子表格,支持公式(#+TBLFM),可用 C-c C-c 重新计算、C-c | 从区域创建表格。
  • 链接:支持外部 URL、本地文件、同文件标题、ID 链接、命名目标等,并提供链接类型选择决策树。
  • 块:QUOTE、EXAMPLE、CENTER、VERSE 等特殊内容块。
  • 标记:粗体、斜体、下划线、逐字、代码、删除线。
  • 脚注:支持引用式与内联式脚注。

GTD 工作流

  • 任务状态工作流:通过 #+TODO 定义 TODO、NEXT、WAITING、DONE、CANCELLED 等状态,支持 @ 提示备注、! 记录时间戳、| 分隔活动与完成状态。
  • 捕获模板:提供捕获模板类型决策树,覆盖任务、参考笔记、日志、会议记录、列表项等。
  • 议程:org-agenda-files 与 org-agenda-custom-commands 配置,支持仪表盘、周回顾等自定义视图。
  • 重构(refile):org-refile-targets 等配置,C-c C-w 重构条目。
  • 时钟计时:LOGBOOK 中记录 CLOCK,支持持久化、恢复、报告等配置。
  • 标签:通过 #+TAGS 与 org-tag-alist 定义上下文标签(@home、@work 等)。
  • 归档:org-archive-location 配置,C-c C-x C-a 归档子树。
  • 任务状态选择决策树。

Org Babel

  • 代码块执行与结果处理::results 支持 value、output、silent、replace、append 等;:exports 支持 code、results、both、none;还支持 :var、:dir、:session、:tangle、:noweb 等头参数。
  • tangle:将源代码提取到文件,支持 :shebang、:mkdirp,C-c C-v t 执行。
  • noweb:通过命名块与 :noweb-ref 实现文学编程。
  • 结果处理:value、output、table 等结果类型示例。
  • 语言特定配置:org-babel-do-load-languages 启用 emacs-lisp、python、shell、js、sql、C、haskell、ruby、plantuml 等。
  • 内联代码:src_python{...}、src_elisp{...} 形式。
  • 结果类型决策树。

导出

  • HTML 导出:org-html-* 配置,C-c C-e h h。
  • LaTeX/PDF 导出:LATEX_CLASS、LATEX_HEADER、org-latex-pdf-process 等,C-c C-e l p。
  • Beamer 演示:BEAMER_THEME、BEAMER_COLOR_THEME、overlay 等,H:2 表示二级标题成为帧。
  • Markdown 导出:ox-md、ox-gfm,C-c C-e m m。
  • 发布:org-publish-project-alist 多文件发布项目,C-c C-e P p。
  • 引用:org-cite(Org 9.5+ 内置),支持 #+BIBLIOGRAPHY、[cite:@key]、#+PRINT_BIBLIOGRAPHY。
  • 选择性导出::noexport: 标签、#+BEGIN_COMMENT、@@html:...@@、#+BEGIN_EXPORT。
  • 导出后端决策树:HTML、PDF via LaTeX、Beamer、Markdown、ODT。

其他

  • Context7 集成:通过 Context7 MCP 获取最新 Org-mode 文档,验证 Org 9.7+ 特性。
  • 最佳实践:每个主要项目或职责领域使用一个文件、保持 inbox.org 用于快速捕获、统一 TODO 状态、为时间敏感任务添加 SCHEDULED 或 DEADLINE、使用上下文标签、定期归档、使用 org-id 建立稳定跨文件链接、设置 :EFFORT: 属性、使用列视图、配置议程自定义命令、使用 org-cite、使用 org-roam v2 进行 Zettelkasten 式知识管理。
  • 反模式:把所有内容放在一个 org 文件中,应按项目、领域或主题拆分并使用 org-agenda-files。
  • 错误升级:涵盖轻微格式不一致、Babel 块执行错误、导出失败或输出损坏、tangle 失败或文件损坏导致的数据丢失。
  • org-roam:Org-roam v2 提供 Zettelkasten 式知识管理与反向链接。
  • 相关技能与相关代理:Emacs Lisp 配置、符号操作、获取最新 org-mode 文档、文档模式;定位代码模式、审查实现质量、分析代码复杂度。

使用方式

该技能以参考文档形式提供 Org-mode 的语法、配置示例和决策树。用户可在提出 org 相关需求时获得对应指导。具体安装或调用方式暂未提供。

适用场景

  • 编写或编辑 .org 文件、org 文档。
  • 配置 GTD 工作流、议程、捕获模板、时钟计时、归档。
  • 使用 Org Babel 执行代码、tangle、noweb、内联代码。
  • 将 org 导出为 HTML、PDF、Beamer、Markdown 或发布多文件项目。
  • 使用 org-cite 引用与 org-roam 知识管理。

限制

  • 该技能依赖 Emacs 与 Org-mode 环境;具体版本要求除文中提及 Org 9.7+(随 Emacs 30.2 捆绑)外,暂未提供。
  • 部分功能(如 citeproc、biblatex 处理器)需通过包获得,具体安装方式暂未提供。
  • 收费、价格、平台等信息暂未提供。