用途:在用户准备将 Emacs Lisp 包提交到 MELPA、编写或审查 MELPA recipe、决定哪些文件随包发布,或处理 MELPA 人工审查意见时使用。
主要能力:以 package-build 的构建模型为核心——构建产物由源码派生,而非直接发布工作树。它会从主库头部生成包描述符 NAME-pkg.el、生成 autoloads,并从仓库打上版本号。因此这些生成物不应手写或提交,否则会被覆盖或发布过期副本。主库的注释头部被视为包元数据的唯一来源,描述符、autoloads、版本都由其机械派生。
recipe 格式:recipe 是 archive 的 recipes/ 目录下的单个文件,文件名与包名完全一致且无扩展名,内容为一个 Lisp 形式 (NAME :fetcher ... KEYWORDS...)。文件名必须等于包名与主库的 feature 名。示例头部包含 Author、Maintainer、URL、Version、Keywords、Package-Requires 等字段,以及 GPLv3 声明、Commentary 和 Code 段,结尾为 (provide 'foo) 与 ;;; foo.el ends here。摘要行需在 80 字符以内,并带 lexical-binding cookie;Keywords 以空格分隔,取自标准 finder 关键字列表,置于 Package-Requires 之前。
静态检查:提交前对每个发布文件运行 package-lint 与 checkdoc,二者验证的是具体失败项,区别于人工审查的风格建议。
审查发现:将 MELPA 人工审查及两个工具反复提出的问题分为阻塞项(recipe 不被接受或包行为异常)与可延后项(风格或设计取舍)。不要通过削弱真实设计决策来消除发现,而应记录延后原因。
反模式:因“构建需要”而提交 NAME-pkg.el 或生成的 autoloads;应让 package-build 生成,只保留源码,并通过 :files 排除本地生成副本。
:files 决策:默认集合已包含源码并排除测试,通常无需覆盖;如需覆盖,应显式包含源码并排除生成文件;文档 glob 需最小化;不应发布的文件应显式排除。
相关技能与代理:涉及 Emacs Lisp 语言、package.el 与编辑器集成基础;宏密集源码仍需满足 package-lint 前缀与 docstring 检查;预接受窗口期的 README、Commentary 与 changelog 措辞;检查含义不明时查阅当前 package-lint / package.el 文档。代理用于对照本指南审查包头部、docstring 与 lint 发现,定位仓库中发布文件与生成文件的差异及 recipe/Makefile 漂移,并使 README/changelog 的可用性声明与实际接受状态一致。
限制:资料未提供具体命令、完整代码示例、收费或平台信息。