Codex Agent 配置与技能集

这个目录用于维护一组面向 Codex 的本地行为规则、技能说明和少量自动化脚本。它不是应用运行时项目，也不包含需要构建启动的服务；它的主要产物是给 Codex 读取的 Markdown、YAML 和脚本文件，用来约束代理在不同任务中的工作方式。

用途

本项目解决三个问题：

1. 为 Codex 提供稳定的通用工程默认行为，例如先读代码、保持小范围修改、保留用户改动、使用确定性命令验证结果。
2. 把可复用工作流封装成技能，例如技术写作、代码审慎实现、代码后置简化、Rust 项目约束注入、Git 提交说明生成、Codex 状态整理、Solana 合约分析、严格代码质量审查和周报总结。
3. 让不同技能拥有独立边界，避免把所有规则堆在一个全局提示里，降低长期维护成本。

目录结构

.
├── AGENT.md
└── skills/
    ├── AGENT.md
    ├── auto-optimize/
    ├── code-simplifier/
    ├── codex-dynamic-workflows/
    ├── codex-fluent/
    ├── codex-retrospective/
    ├── git-commit-release-notes/
    ├── karpathy-guidelines/
    ├── rust-agent-md/
    ├── solana-opponent-contract-analysis/
    ├── technical-writing/
    ├── thermo-nuclear-code-quality-review/
    └── weekly-review/

关键文件和目录：

• AGENT.md：全局默认行为。保持短小，只放所有任务都适用的规则。
• skills/：技能集合。每个子目录代表一个可独立触发的工作流。
• skills/*/SKILL.md：技能入口，包含触发条件、工作流程、边界和输出要求。
• skills/*/agents/openai.yaml：技能在 Codex 中的展示名、简短说明、默认提示和隐式触发策略。
• skills/*/references/：技能需要的参考材料或模板。
• skills/*/scripts/：技能可复用的本地脚本。
• skills/*/assets/：报告模板等静态资源。
• skills/auto-optimize/rules/：不同语言的自动优化规则。

技能概览

技能	用途
karpathy-guidelines	为实现、调试、重构、评审等代码任务提供谨慎的工程默认行为。
code-simplifier	对最近修改的代码做窄范围简化，保持行为不变并减少无谓复杂度。
technical-writing	编写、改写和润色中文或中英混合技术文档。
rust-agent-md	向已有 Rust agent 文件添加短入口，并在同级生成 good_bad_examples.md 承载详细 Rust 工程约束。
git-commit-release-notes	根据当前 diff 生成 release-note-ready 的 Conventional Commit，并更新 CHANGELOG.md。
auto-optimize	使用 Codex 对目标项目做探索、评估、任务拆解和持续优化。
codex-dynamic-workflows	针对复杂任务提供动态编排、分包协作、风险门禁和复用的工作流执行框架。
codex-fluent	诊断和整理 Codex 本地状态，例如旧会话、日志、worktree 和归档流程。
codex-retrospective	复盘近期 Codex 使用历史，提炼可持久化的行为改进。
solana-opponent-contract-analysis	分析未知或竞争对手的 Solana 可执行程序，并生成证据驱动的 HTML 报告。
thermo-nuclear-code-quality-review	执行高强度维护性审查，重点检查抽象质量、分支复杂度、层边界和 800 行文件红线。
weekly-review	基于最近 authored commits 生成简短周报，并按 bugfix、tech debt 和 net-new 工作分类。

使用方式

这个目录更适合作为「本地 Codex 配置源」维护。常见使用方式是把需要生效的内容同步到 Codex 的配置目录，例如：

cp AGENT.md ~/.codex/AGENT.md
cp -R skills/* ~/.codex/skills/

如果只想启用某个技能，也可以只同步对应子目录：

cp -R skills/technical-writing ~/.codex/skills/

同步后，在新会话中通过技能名或匹配的任务描述触发对应工作流。技能是否允许隐式调用由各自的 agents/openai.yaml 控制。

codex-dynamic-workflows 使用方法（复杂任务）

1. 先编写 plan.md 计划文件，明确任务目标、成功标准与工作包划分。
2. 在新会话中执行：

/goal 使用codex-dynamic-workflows 执行 plan.md 任务

建议把 plan.md 放在 .workflow/<slug>/plan.md，并确认目标、成功标准、风险与验证项已完整写入。

维护原则

• 全局规则放在根目录 AGENT.md，只保留所有任务都需要的默认行为。
• 具体工作流放进对应技能，避免在全局规则里堆叠长流程。
• 技能的 description 需要覆盖真实触发场景，因为它是自动选择技能的重要依据。
• 脚本类能力优先放在 scripts/，避免把长命令或机械流程重复写进提示。
• 参考材料放在 references/，按需读取，不把大段背景塞进入口文件。
• 新增技能时先明确触发条件、边界、输入输出和验证方式，再补充模板或脚本。

当前边界

• 本项目没有统一构建命令。
• 本项目没有应用入口或服务进程。
• 文档和技能内容需要通过 Codex 的技能加载机制生效。
• 涉及真实项目修改时，仍应以目标项目自己的 AGENTS.md、测试命令和仓库约定为准。