Codex Skills

面向 Codex 的可复用项目管理 Skill。目前包含 codex-project-manager，用于审查项目架构、治理文档目录、维护实施计划和记录项目状态。

Skills

Skill	用途	状态
codex-project-manager	项目文档审计、目录治理、架构/决策/计划/进度/排障记录	Current

架构

skills/codex-project-manager/
├── SKILL.md
├── agents/
│   └── openai.yaml
└── references/
    ├── documentation-system.md
    ├── conversation-naming.md
    └── project-state.md

• SKILL.md：触发条件、核心工作流和安全边界。
• agents/openai.yaml：Codex 界面名称、简介和默认调用语句。
• references/documentation-system.md：按需读取的文档目录与索引规范。
• references/conversation-naming.md：Codex 对话与任务标题的“项目故事命名法”。
• references/project-state.md：按需读取的检查点、进度、ADR 和排障记录规范。

工作流

读取仓库规则
→ 盘点代码、文档和 Git 状态
→ 用代码、配置、测试和历史建立证据
→ 选择最小文档集
→ 规划并执行文件变更
→ 更新索引
→ 校验链接、命令和行为
→ 输出已验证、已变更、阻塞与下一步

Skill 不会默认执行大规模移动、删除、提交、推送、Git hooks 或 GitHub Actions；这些操作需要用户明确授权。

安装

使用 Codex 的 $skill-installer：

$skill-installer install https://github.com/black605/codex-project-manager/tree/main/skills/codex-project-manager

也可以手动复制到全局 Skill 目录：

git clone https://github.com/black605/codex-project-manager.git
cp -R ./codex-project-manager/skills/codex-project-manager ~/.codex/skills/

安装后重启 Codex。

使用

$codex-project-manager 审查当前仓库的架构和文档目录，先给出变更方案。

$codex-project-manager 根据当前代码与 Git 历史更新项目进度文档。

License

GNU General Public License v3.0