mcpField
D
doom-literate-config

doom-literate-config

github.com/tejas-kale开发038 次安装4 天前更新
代码仓库

关于 doom-literate-config

这项技能用于维护以 Org mode 编写的 Doom Emacs 配置,帮助开发者从生成文件追溯到 config.org、盘点现有设置,并按 Doom 约定进行修改。

主要功能

  1. 01识别代码块的生成文件和目标位置
  2. 02盘点设置与软件包声明
  3. 03在源文件中保留注释
  4. 04使用 Doom 原生配置宏
  5. 05按工具组织 Org 章节

适用场景

  1. 01安全修改 Doom 配置
  2. 02在 packages.el 中添加软件包声明
  3. 03调整按键绑定或软件包设置

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/tejas-kale/skills --skill doom-literate-config

安装后在 Claude Code 中输入/doom-literate-config确认已加载。

详细介绍

Doom 文学化配置

在文学化配置中,config.org 是源文件,其他所有文件都是缠结生成的——导出时生成,并会被覆盖。所有编辑都应在源文件中进行;对缠结文件的编辑会在下次缠结时丢失。

1. 确认各内容缠结到哪里

阅读 init.el、config.org、config.el 和 packages.el。

  • init.el 中的 :config literate 会将 config.org 设为源文件。
  • 普通的 emacs-lisp 代码块会缠结到 config.el。
  • 标记为 :tangle packages.el 的代码块会缠结到 packages.el;package! 声明需要使用此标记。

完成标准:你能说出源文件,以及每个准备修改的代码块的缠结目标文件。

2. 清点当前配置

首次编辑前,清点 config.el 中每个生效的设置,以及 packages.el 中的每个 package! 声明,并确认它们在 config.org 中都有对应内容。

将 packages.el 中的注释移入缠结到 packages.el 的 config.org 代码块,使其在重新生成后得以保留。

完成标准:缠结文件中的每个生效设置、声明和注释,都能在源文件中找到对应内容——要么保留,要么有意删除。

3. 采用最精简的 Doom 原生改动

优先使用 Doom 宏,而不是原始 Emacs Lisp:

任务使用
声明外部包package!(位于 packages.el 代码块中)
配置包use-package!
绑定按键map!
设置默认字体doom-font
设置新窗口框架的几何参数default-frame-alist

为每个工具单独创建一个 config.org 章节和代码块,并在配置代码块之前添加其前置条件代码块。

完成标准:每个修改过的行都对应用户明确表达的偏好。

评论

支持 Markdown