codex-lazy-pack

给执行安装的 Codex：收到本仓库链接或目录后，先读取根目录 SKILL.md、 sources.lock.json 和共享安装规则，再按用户选择执行 00–05。 本仓库的根目录和 skills/ 是安装入口；实际待安装内容由锁文件指定。请先解析入口，再调用具体 Skill 的安装能力。

这是我的个人 Codex 懒人包。它把常用工程工作流、代码工程和 GitHub/Obsidian Skill 固定到指定 commit，并在仓库内维护个人第二大脑 Skill。新机器上只需要把这个仓库交给大模型，通过对话即可选择并 完成用户级安装；首次安装 05 时还会引导配置 Windows 主 Vault 与 SSH Linux 服务器的 Syncthing 双机同步、服务器镜像和 PC 端 GitHub 人工备份。更新已安装版本时不会重跑双机配置。 第二大脑完成一次性配置后，会通过用户级全局规则自然融入项目工作，不需要手动提醒开工、记录或收工。

当前懒人包版本：0.15.0。个人第二大脑采用 Foam-inspired Schema 2；Vault schema 为 2，设备配置 schema 为 2。

本项目采用“总入口 + 独立懒人包”的组织方式：

• 总入口和选择路由：SKILL.md
• 独立懒人包：skills/<name>/SKILL.md
• 上游版本锁定清单：sources.lock.json
• 共享安装规则：references/conversation-install.md
• 安装后验收：references/post-install-verification-prompt.md

快速开始：通过对话安装

将本仓库链接或目录交给 Codex，并发送：

请安装 https://github.com/impecme/codex-skill-pack 中的懒人包。

大模型应先读取 SKILL.md，根据你的选择再读取对应的 skills/<name>/SKILL.md 和对话式安装规则，最后逐项安装并报告结果。

未指定编号时，Codex 先展示 00–05 供你选择；你也可以直接说“全部”。安装前会确认当前客户端的用户级 Skill 目录、有效全局规则文件，以及 00 所需模型是否可用。配置目录和 Skill 目录分别解析，不能只凭目录存在就判定能够加载。 本次仓库说明和内置资产来自同一份快照；外部来源继续固定到锁文件中的 commit。

完成报告会分别列出“文件安装状态”“Codex 发现状态”和“功能验证状态”。新会话才能完成的检查会标记为待验证； 除 05 明确选择并确认的第二大脑初始化、同步和本机备份配置外，安装时不执行 GitHub 登录或其他 Skill 的业务操作。Matt Pocock 的隐式调用限制、全局建议区块和缺失依赖按 兼容性说明检查。

安装完成后，Codex 还会提供一份独立的安装后验证提示词，供你复制到同一 Codex profile 的新对话中验收文件安装、客户端发现和只读功能测试。

可用懒人包

编号	名称	内容
00	codex-sol-luna-workflow	Luna/Sol 工程工作流配置、AGENTS.md 和两个 agent 配置
01	codex-mattpocock-engineering	mattpocock/skills Engineering 目录的 18 项技能，以及对九项非自动调用 Skill 的全局建议规则
02	codex-github	GitHub CLI、Git 配置和 GitHub 访问工作流
03	codex-obsidian	Obsidian Vault 授权、MCPVault 和读写验证工作流
04	codex-github-obsidian	GitHub 与 Obsidian 的联动工作流
05	codex-second-brain	Windows PC 主 Vault（新建时外层目录建议名为“第二大脑”）、SSH Linux 镜像；分阶段 Syncthing 配对/首次传输/核验；仅 PC 人工 GitHub 备份（双机引导）
全部	—	依次安装 00 至 05

对应入口：

• 00：Luna/Sol 工程工作流
• 01：Matt Pocock Engineering 技能
• 02：GitHub
• 03：Obsidian
• 04：GitHub + Obsidian
• 05：第二大脑

00：Luna/Sol 工程工作流

来源：impecme/sol-luna-engineering-workflow

该来源是基于官方仓库 BruceLanLan/sol-luna-engineering-workflow 的个人 fork。

锁定 commit：c1376779ada82ed540e052a74d23538c07f1a1e6

模型配置：默认使用 gpt-6-luna + max；困难判断使用 gpt-6.1-sol + high。

安装到用户级 Codex 目录（通常是 ~/.codex）：

• AGENTS.md
• config.toml
• agents/luna-worker.toml
• agents/sol-advisor.toml

上游 README、文档和贡献指南不会被复制到用户配置目录。

01：Matt Pocock Engineering 技能

来源：mattpocock/skills Engineering

锁定 commit：3cca18b368ae95cdbdebbff572ccafa662551015

选择 01 或“全部”时，18 项都会安装到用户级 Skill 目录：

ask-matt、code-review、codebase-design、diagnosing-bugs、domain-modeling、 grill-with-docs、implement、improve-codebase-architecture、prototype、research、 resolving-merge-conflicts、setup-matt-pocock-skills、tdd、to-spec、to-tickets、 triage、wayfinder、wizard。

同时，01 会按确认流程把全局建议规则合并到用户级 <CodexHome>/AGENTS.md。它会在具体工作与某项 Skill 高度匹配时推荐一项手动调用并等待你选择；拒绝后照常继续，不会自动启动 Skill。 规则只修改自己的受管区块，保留其他全局内容；若 AGENTS.override.md 遮蔽基础文件，不修改 override，并把有效状态报告为 blocked。 上游九项 Skill 的自动调用限制保持原样，手动调用菜单是否可用仍按当前客户端单独验证。

02–04：GitHub 与 Obsidian 相关 Skill

这三项来自 mathruffian-dot/codex-lazy-packs， 固定在 574818e2d80b31807b74fcf62dd5b90b9e46ef3f：

• 02 安装 codex-github，用于检查 Git、GitHub CLI、GitHub 登录状态和后续 GitHub 工作流。
• 03 安装 codex-obsidian，用于选择 Vault 授权方式、配置可选的 MCPVault，并验证读写。
• 04 安装 codex-github-obsidian，用于执行 GitHub 与 Obsidian 的组合工作流。

这里的“安装”只把固定版本的 Skill 放入用户级 Skill 目录，不会在懒人包安装阶段自动登录 GitHub、修改全局 Git 配置、创建或推送仓库、写入 Obsidian Vault，也不会自动保存凭证。 安装完成后，再通过对话触发相应的已安装 Skill。

05：个人第二大脑（Foam-inspired Schema 2）

05 安装本仓库维护的 codex-second-brain， 不再使用参考仓库中的简版三层结构 Skill。它还会把 global-agents-section.md 作为受管区块合并到 用户级 <CodexHome>/AGENTS.md，使 Skill 不依赖用户每次显式触发。

该内置 Skill 的指令、生成模板和默认笔记内容均使用简体中文；新建笔记文件名中的可读主题部分和新建 Vault 的内部一级目录也优先使用中文。 新建 Vault 默认采用带数字前缀的中文布局；既有 ASCII 布局继续兼容，升级不会迁移、重命名或创建重复目录。布局身份记录在系统清单中；检测到混合或不明确布局时停止相关写入。index.md/status.md 等固定系统文件名、项目内部目录、机器字段、模式标识和各类 ID 保持 ASCII。它坚持一个 Vault，不为每个项目建立独立事实源：

Vault 外层文件夹名与内部 Schema 目录布局相互独立。新建 Windows 主 Vault 时，默认建议在你选定的父目录下使用中文文件夹名 第二大脑；Codex 会先展示完整绝对路径，得到确认后才创建。SSH 服务器镜像路径需单独确认，不能直接照搬 PC 的绝对路径。安装或更新不会重命名既有 Vault；如果你明确要求改名，必须作为独立迁移核对 Codex、Obsidian、Syncthing 两端及其他路径引用，并先停止相关写入和同步。

• 设备之间只用 Syncthing 同步同一个主 Vault；GitHub 私有仓库只由指定设备人工 commit/push，作为备份和历史审查，不承担实时同步。
• 项目使用 index.md 保存身份和导航，status.md 保存生命周期、当前目标、进度、阻塞和下一步；经验拆成 lessons/ 下的原子笔记，避免一个不断膨胀的 lessons 文件。
• 长期知识按当前布局的 Knowledge 目录（新建 Vault 为 30-知识/<topic>/）组织，每个主题有自己的 index.md，主题笔记保持单主题、可独立引用。
• 每个受管笔记都有不可变的“类型前缀 + UUIDv4”身份；project_id 继续表示规范化仓库映射，不与笔记 UUID 混用。
• 内部链接使用 Vault 根相对、路径限定的 Wikilink（新建中文布局示例：[[10-项目/<project-id>/status|项目状态]]），不带前导 / 或 .md，不依赖可能产生歧义的全库同名链接。
• Skill 随包提供 16 个模板和 Schema 2 资产；初始化后，Vault 内所选布局的 templates/ 是模板权威，schemas/schema-v2.md 与系统清单记录当前约定，Skill 目录中的资产只用于 bootstrap、repair 或 fallback。
• setup、link、startup、checkpoint、shutdown、weekly、promote 和 repair 是内部动作，不是用户操作清单。

Schema 2 的稳定目录骨架如下：

<Vault>/
├─ index.md
├─ 00-收件箱/
│  ├─ <year>/<month>/<timestamp>-<device-short>-<中文主题>.md
│  └─ 每周整理-<year>-W<week>-<device-short>.md
├─ 10-项目/
│  ├─ index.md
│  └─ <project-id>/
│     ├─ index.md
│     ├─ status.md
│     ├─ sessions/<year>/<timestamp>-<device-short>-<id8>-<中文摘要>.md
│     ├─ decisions/<decision-id>-<中文主题>.md
│     ├─ experiments/<experiment-id>-<中文主题>.md
│     └─ lessons/<lesson-id>-<中文主题>.md
├─ 20-领域/
│  ├─ index.md
│  └─ <area-id>/index.md
├─ 30-知识/
│  ├─ index.md
│  └─ <topic-id>/
│     ├─ index.md
│     └─ <knowledge-id>-<中文主题>.md
├─ 40-资源/
│  ├─ index.md
│  └─ <web|paper|book|repository|other>/<resource-id>-<中文主题>.md
├─ 50-日记/
│  └─ <year>/<YYYY-MM-DD>.md
├─ 60-归档/
├─ 90-系统/
│  ├─ second-brain.md
│  ├─ schemas/schema-v2.md
│  └─ templates/
└─ 附件/

新建中文布局与既有 ASCII 布局的一级目录一一对应：00-收件箱/00-Inbox、10-项目/10-Projects、20-领域/20-Areas、30-知识/30-Knowledge、40-资源/40-Resources、50-日记/50-Daily、60-归档/60-Archive、90-系统/90-System、附件/attachments。新建时用中文；已有 Vault 按其运行时 Schema 和系统清单继续使用原布局。若两套标记混杂或无法识别，先报告并停止写入，不自动整理或迁移。附件 是推荐目录名，Obsidian 实际附件保存位置仍以 .obsidian/app.json 为准；本懒人包不擅自改该设置或移动附件。

安装 05 时，Codex 会先分别确认设备角色与本机 Vault 路径：Windows 个人电脑是主 Vault 和唯一 GitHub 人工备份设备；SSH Linux 服务器只使用经你确认的空目录作为镜像，不创建第二份知识库。个人电脑的既有 Vault 路径和外层名称保留原样；如果是新建空 Vault，默认建议使用 第二大脑 作为外层目录名，先确认完整路径再按 Schema 2 初始化。服务器不会自行初始化笔记内容，而是在配对后接收 PC 主 Vault。 在已记录配对对端的设备上重复安装 05 时，只读核验并保留当前配对、播种、晋级或双向状态，不会把 folder 暂停或退回首次安装网络基线。

两台设备分别生成 Syncthing 配对卡，由你在两边 Codex 对话间人工传递。配对卡只包含设备标签、Syncthing Device ID、固定 folder ID、角色和传输方向；不含本地路径、第二大脑 deviceId、凭证或 SSH 私钥。配对时只登记双方设备和共享文件夹，保持暂停。初次传输前 PC 为 sendonly，服务器为 receiveonly；必须确认两端 Obsidian、Codex 和其他 Vault 写入者都已停写。首次传输后验证服务器 idle、无待同步项/错误/receive-only 本地差异，并比较双方内容 manifest SHA-256；通过后先将服务器切为 sendreceive，复核一致后再将 PC 切为 sendreceive。

在你知情并确认后，Syncthing 才启用公共设备发现和官方 relay；监听保留 TCP loopback 并加入官方动态 relay 地址，不监听所有网卡。关闭 LAN 发现、LAN 地址公告和 Syncthing 自身的 NAT/UPnP 映射，不自动修改防火墙、路由器或端口转发；不打开浏览器。公共发现/relay 会接触设备 ID、IP 等连接元数据，传输内容仍由设备间 TLS 保护。若系统防火墙或网络策略阻止 relay 出站连接，Codex 会报告需要你或管理员处理的步骤，不自行提权或更改网络设备。

Linux 无桌面服务器使用 systemd 用户服务；还需检查 linger，若需要管理员启用，Codex 会给出命令让你自己执行，不会静默使用 sudo。服务不强制 --paused，重启后按 Syncthing 保存的文件夹状态恢复同步。GitHub 私有仓库只在 PC 上按 人工备份引导确认本地 Git/远端配置；提交和推送仍由你逐项触发，不建每周自动化。

你仍需亲自介入的部分

• 在 Windows 个人电脑和 SSH Linux 服务器各自的 Codex 环境中安装/执行一次 05。一个设备上的 Codex 不能代另一台设备写入本机配置或登录启动项。
• 提供或确认两端各自的 Vault 绝对路径；新建 PC 主 Vault 时可采用“所选父目录/第二大脑”，并确认完整路径；如果 PC 主 Vault 为空，确认是否初始化 Schema 2；服务器目标路径必须为空，创建前会再次确认。
• 把两端 Codex 生成的 Syncthing 配对卡、服务器 receiver-ready 状态、manifest SHA-256 和后续核验结果，在两个对话间复制传递。卡片不含 Vault 路径或凭证。
• 首次传输前，亲自确认两端 Obsidian、Codex、脚本等 Vault 写入者都已停止；在首次播种、服务器晋级和 PC 晋级各阶段按提示确认。Codex 不会假设另一台设备已停写。
• 若服务器缺少 systemd linger，你需按提示自行执行管理员命令；如果公共 relay 出站被网络策略阻止，需你或管理员处理网络限制。Codex 不打开 GUI、不提权、不改防火墙或路由器。
• GitHub 端需你选择/创建私有仓库并在本机完成认证；Git 初始化、远端设置、暂存、提交和推送均按步骤单独确认。

路径不确定、服务器目录非空、未知设备、身份/路径冲突、Schema 1 迁移或同步验证失败时，停止相关写入与阶段转换、保留双方数据和配置备份；不阻断其他所选 Skill 安装。普通项目对话也不会因第二大脑暂不可用而停止。完整步骤和每阶段报告项见双机引导。

05 不安装 Foam、foam-cli、VS Code 扩展或任何 MCP，也不提供用户自行运行的一键安装器。Codex 在 05 对话中调用内置 Python 3.10+ 标准库辅助程序；不自动安装 Python。详细的预检、冲突和安全边界见 syncthing-bootstrap.md。本次变化不改变 00–04。 完整方案见第二大脑更新方案和 开源第二大脑组织形式调研。

第二大脑如何融入日常任务

普通项目任务的外部体验仍然是“提出任务 → Codex 完成任务 → 获得结果”。内部按需发生：

首次处理当前项目任务：静默读取项目 index、status 和最近 Session
实际开发、调试、测试、研究或评审：优先完成项目工作
产生持久成果：写入当前任务唯一的设备独立 Session
最终回复前：补全结果、证据、阻塞和下一步

不会为每个命令、工具调用或对话轮次写笔记，也不会把同一正文复制到 Daily、Session、status、lessons 和 Knowledge。 普通问答或没有持久结果的检查不写入。只有首次建库、首次关联项目、共享状态或正式知识修改、冲突处理、移动删除 以及 Git commit/push 等必要动作才会要求确认。

对话式安装行为

• 用户未选择编号时只展示清单，不直接修改用户级配置。
• 大模型直接使用可用的 Codex Skill、文件和仓库工具完成安装。
• 外部上游内容按 sources.lock.json 中的 commit 获取；内置第二大脑 Skill 按懒人包版本和仓库 commit 追踪。
• 不提供或要求用户自行运行本地一键安装脚本；只有 05 允许 Codex 调用内置同步辅助程序。安装过程不使用 npx、不要求 Node.js 或 uv；05 需要已有 Python 3.10+，不会自动安装 Python。Git/GitHub CLI 若缺失只影响 PC 端备份配置，Codex 会说明恢复路径。
• GitHub/Obsidian Skill 后续可能会检查或引导这些工具，但那属于主动使用 Skill 的下一步。
• 不在安装过程中要求 GitHub 登录或自动配置凭证。
• 05 可在用户确认后初始化个人电脑的 Schema 2 Vault、配置双机 Syncthing 并设置 PC 端私有 GitHub 远端；不迁移 Schema 1。服务器只接收主 Vault，不独立初始化笔记。sync-onboarding.json 的 status 不是 active，或存在 pendingOperation 时（即使 status 为 active），全局规则暂停自动恢复与 Vault 写入，直到本机操作恢复且双机内容核验完成。
• 已安装版本更新时，05 只更新可确认归属的 Skill 文件和受管规则，并只读报告既有同步阶段；不会重跑首次配置、连接设备、传输 Vault 内容或改写设备状态。
• 更新已确认归属于懒人包的受管内容时，先备份并核验，再自动以本次锁定版本替换；未知归属、非受管配置和第二大脑运行数据仍保留并按共享规则处理。
• 05 使用稳定注释标记原位维护 AGENTS.md 区块；不得覆盖其他全局规则或追加重复区块。
• 安装完成后提示是否需要重启 Codex，以便刷新新 Skill。

更新、覆盖与恢复

再次安装时，Codex 先读取本机懒人包安装记录，并把已安装项目按更新处理。新版以当前仓库快照和 sources.lock.json 固定 commit 为准；不自动追踪上游分支。

已确认归属于懒人包的 Skill 文件、配置键和受管 AGENTS.md 区块有差异时，Codex 会展示差异、先备份并核验，然后直接更新到锁定新版，不再逐项询问是否替换。受管内容上的本地修改也会被新版替换，并在报告中注明。每次更新的备份保存在 <CodexHome>/lazy-pack/backups/<时间戳>-<运行编号>。

自动覆盖只适用于有安装记录、有效受管标记或可信旧锁定来源可证明归属的内容。未知来源的同名 Skill、无法识别的额外文件、未受管 TOML 键、AGENTS.md 区块外正文不会被覆盖；Codex 会保留它们，并只在确需接管具体范围时询问一次。备份失败、路径不安全、标记损坏或来源无法锁定时，停止受影响的更新并报告，不影响其他独立项目。

更新 05 只更新已安装的第二大脑 Skill 及其受管规则，不重新执行首次配置；不会覆盖 Vault 笔记/模板、Syncthing 设备或配对状态、同步阶段、.stignore、Git 历史，也不会连接设备或传输内容。初次安装配置仍按 05 的阶段确认规则执行。

重复运行且内容已一致时标记为 already-current；实际写入更新后标记为 updated。每次安装报告记录来源 commit、受管路径/键/区块、文件清单与哈希、备份位置、更新结果和待处理项，供下一次识别。

个人开发中的推荐用法

安装后，可以把这些技能组合成通用开发闭环：

1. codex-second-brain 在外围自动恢复当前项目上下文。
2. 用 grill-with-docs / to-spec 固化目标、约束和验收标准。
3. 用 prototype 验证不确定的设计或建立 baseline。
4. 用 implement / tdd 开发，并保持测试和检查可重复执行。
5. 用 diagnosing-bugs 根据证据排查错误和回归。
6. 用 code-review / codebase-design 检查实现质量和架构边界。
7. 用 research 查询需要的一手资料。
8. 在有持久结果的任务结束前，第二大脑自动保存一条简洁 Session；正式知识仍经复核后沉淀。

更新锁定版本

懒人包不会自动追踪上游最新版本。需要升级时，维护者应先修改 sources.lock.json 中的 commit，检查上游变更，再提交这个懒人包的版本更新。这样不同机器仍能复现同一套环境。

插件/MCP 扩展

sources.lock.json 已预留 extensions.plugins 和 extensions.mcp 数组。本次 Schema 2 / 05 不安装 Foam、CLI、VS Code 扩展或 MCP， 也不会自动扫描或安装未确认的插件、MCP server 或凭证配置。本项目本身不作为 Codex 插件安装；00–04 的既有入口和行为不在本次变更范围内。

范围说明

当前版本封装三个外部固定来源类别：个人 fork 的 Luna/Sol 工作流、Matt Pocock Engineering 技能， 以及 mathruffian-dot 懒人包中的 GitHub/Obsidian Skill；个人第二大脑 Skill 由本仓库直接维护。 工作区中的本地资料不会自动复制；如需加入个人常用资料或 Skill，可以在后续版本新增独立的 skills/<name>/SKILL.md 和对应来源。