Mechanism Memo
best-minds-minimalist 模板：系统级还是仓库级？
2026-01-25 13:09 · 使用该 skill 的你（跨仓库） · Codex CLI skills · 本仓库 myObsidian
澄清：模板来源/覆盖规则；并用当前仓库文件路径举例。
要点速览
结论
- Skill 规则是系统级：安装在
~/.codex/skills/...（所有仓库共享）。 - HTML 模板通常是仓库级：按相对路径
assets/modern-minimalist-report.html从当前仓库读取，因此不同仓库可以不一样。 - 系统级也有一份默认模板：可当“母版/兜底”。
当前仓库（已验证）
- 仓库模板：
assets/modern-minimalist-report.html - 系统模板：
~/.codex/skills/best-minds-minimalist/assets/modern-minimalist-report.html - 输出目录：
docs/reports/
关键洞见
- 相对路径 = 仓库可覆盖：skill 文档里写
assets/...，意味着“当前工作目录（仓库）里有什么就读什么”。 - 系统级模板更像默认基线：适合用来初始化/拷贝到新仓库，而不是让团队依赖每个人机器上的隐式文件。
- 仓库内自动化更偏向仓库模板：因为它可被 Git 追踪，结果更可复现。
步骤指南（新手友好）
判断与改法
- 看当前仓库是否有
assets/modern-minimalist-report.html：有则优先当作“本仓库模板”。 - 若你希望跨仓库统一：把系统模板当母版，然后复制/同步到每个仓库的
assets/...（让模板进入版本控制）。 - 若你希望只改当前仓库：直接修改本仓库的
assets/modern-minimalist-report.html即可。
SVG 图解
专家视角（best minds）
技能作者视角（paraphrase）
- Thesis：skill 的工作流说明可以全局共享，但模板/版式最好允许项目自定义。
- Reason：不同仓库的信息密度、章节与读者不一样，模板放仓库里更灵活。
- Limit：必须把“查找顺序”说清楚，否则用户会以为是系统在自动选模板。
工具链/可复现视角（paraphrase）
- Thesis：默认优先仓库内模板，避免环境差异导致输出漂移。
- Practice：把模板纳入 Git；系统模板只做初始化与更新来源。
- Risk：多仓库同步成本，需要“复制/脚本同步/模板仓库”策略。
方案
| Option | 适合 | 怎么做 | 代价/风险 |
|---|---|---|---|
| 仓库级模板 | 每仓库风格不同 | 改 assets/modern-minimalist-report.html | 跨仓库不一致 |
| 系统级模板 | 你个人想全局统一 | 改 ~/.codex/skills/.../assets/modern-minimalist-report.html | 团队协作/复现较差（隐式依赖） |
| 混合（系统作母版，仓库复制） | 既统一又可控 | 复制系统模板到各仓库 assets/... | 需要同步流程 |
证据与置信度
| Claim | Evidence | Confidence | Source |
|---|---|---|---|
| 当前仓库存在仓库级模板 | 发现 assets/modern-minimalist-report.html | High | 本地文件系统 |
| 系统级也存在默认模板 | 发现 ~/.codex/skills/best-minds-minimalist/assets/modern-minimalist-report.html | High | 本地文件系统 |
| 本仓库脚本读取仓库模板 | scripts/ingest-issue.mjs 使用 path.join("assets", "modern-minimalist-report.html") | High | 仓库源码 |
下一步
- 只改当前仓库：编辑
assets/modern-minimalist-report.html。 - 想跨仓库统一：把系统模板当母版，建立“复制/同步到各仓库 assets”流程。
细节（可选）
关键点：为什么说它是“仓库级”
当模板路径写成 assets/modern-minimalist-report.html（相对路径）时，默认以当前工作目录解析，所以每个仓库放一份即可覆盖。
实操建议：怎么避免“隐式系统依赖”
- 把模板文件纳入仓库（Git tracked），确保同一仓库在不同机器上生成结果一致。
- 把系统模板当作上游母版：更新后再选择性同步到仓库。
来源
assets/modern-minimalist-report.html（当前仓库模板）scripts/ingest-issue.mjs（模板读取逻辑）/Users/zon/.codex/skills/best-minds-minimalist/SKILL.md（skill 规则）/Users/zon/.codex/skills/best-minds-minimalist/assets/modern-minimalist-report.html（系统默认模板）
收尾总结
这套 skill 的“工作流/规则”来自系统级安装，但它引用的 HTML 模板在实践里通常是当前仓库的 assets/modern-minimalist-report.html（相对路径）。
如果你在不同仓库看到输出版式不同，优先去看各自仓库的 assets/ 是否有自己的模板。
一个下一步动作
对比并决定：以“仓库模板”为准（推荐可复现），还是维护“系统模板”作为母版并同步到各仓库。
“把依赖写进仓库，结果才可复现。”
— Tooling note