codex-notes skill:将内容按仓库约定整理保存为笔记
- 日期:2026-08-29
- 项目:codex-notes(仓库:codex-workspaces/codex-notes)
- 涉及组件:Codex skill(~/.codex/skills/codex-notes)、skill-creator、README.md
- 状态:已完成(含测试)
背景
为把部署与运维内容按仓库约定方便地落盘,使用 skill-creator 创建了 codex-notes skill,安装在 ~/.codex/skills/codex-notes。skill 以仓库 README.md 的约定为准,自动判断项目/类别文件夹,并生成符合格式的笔记文件。
完成内容
- 初始化 skill 骨架(
SKILL.md+agents/openai.yaml),并通过quick_validate.py校验。 - 目录约定:顶层按项目名分文件夹(如
easyimage、typecho),项目内按类别分子文件夹(troubleshooting故障排查、deploy部署、config配置、meta元笔记/规范),文件名为YYYY-MM-DD-简述.md。 - 格式约定:第 1 行分类、第 2 行标签(英文逗号分隔)、空一行、
# 标题、元信息列表(日期/项目/涉及组件/状态)、<!--more-->、正文;故障排查类在## 根因后追加## 注意事项。 - 按用户反馈确认并修正了元信息列表的位置:正确顺序为“空一行 → 标题 → 元信息”,即元信息列表位于标题之后。
测试
按用户要求,以“将本段对话记录为笔记”作为测试用例:本笔记即由 $codex-notes 生成,落在 meta/ 文件夹,验证了内容归类、文件命名与格式约定。
注意事项
- 仓库实际目录名是
codex-notes(复数),不是codex-note,skill 中已按真实路径配置。 - 本环境
apply_patch因 bwrap 沙箱故障无法写入文件,沿用现有 meta 笔记中的做法,使用带提权的 Python 脚本写入;若沙箱恢复可继续使用apply_patch。 - skill 默认开启自动发现,以后直接说“记入 codex-notes”即可触发。