• 日期: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 的约定为准,自动判断项目/类别文件夹,并生成符合格式的笔记文件。

完成内容

  1. 初始化 skill 骨架(SKILL.md + agents/openai.yaml),并通过 quick_validate.py 校验。
  2. 目录约定:顶层按项目名分文件夹(如 easyimagetypecho),项目内按类别分子文件夹(troubleshooting 故障排查、deploy 部署、config 配置、meta 元笔记/规范),文件名为 YYYY-MM-DD-简述.md
  3. 格式约定:第 1 行分类、第 2 行标签(英文逗号分隔)、空一行、# 标题、元信息列表(日期/项目/涉及组件/状态)、<!--more-->、正文;故障排查类在 ## 根因 后追加 ## 注意事项
  4. 按用户反馈确认并修正了元信息列表的位置:正确顺序为“空一行 → 标题 → 元信息”,即元信息列表位于标题之后。

测试

按用户要求,以“将本段对话记录为笔记”作为测试用例:本笔记即由 $codex-notes 生成,落在 meta/ 文件夹,验证了内容归类、文件命名与格式约定。

注意事项

  • 仓库实际目录名是 codex-notes(复数),不是 codex-note,skill 中已按真实路径配置。
  • 本环境 apply_patch 因 bwrap 沙箱故障无法写入文件,沿用现有 meta 笔记中的做法,使用带提权的 Python 脚本写入;若沙箱恢复可继续使用 apply_patch
  • skill 默认开启自动发现,以后直接说“记入 codex-notes”即可触发。

标签: codex-notes, markdown, skill-creator

添加新评论