Dev Skills

开发技能

可重用的版本化集合 代理技能 （根据AgentSkills规范），我使用它来使编码代理更可靠、一致和快速。

• 规格：
• 技能登记：

此回购中有什么内容

此仓库现在包含技能包和支持工具：

• 可重用技能 skills/;
• repo引导包清单和模板 bootstrap/;
• Rust共享开发合同机箱， codex-dev-core，下 crates/;
• Rust开发CLI， codex-dev，下 crates/;
• 可选的Rust终端工作台， codex-dev-tui，下 crates/;
• Rust研究CLI， codex-research，下 crates/;
• 食品法典委员会次级代理源包 subagents/;
• 跟踪文档 docs/;
• 技能、引导、文档和eval助手 tools/.

从开始 docs/index.md 查看完整的指南集。

关键文件：

• 入职
• 系统概述
• 研究架构
• codex-dev操作层规范
• 开发技能v0.3/v1路线图
• 未来的本地应用程序界面
• codex开发核心参考
• codex-dev-CLI参考
• codex开发TUI参考
• codex research v0.2后续规范
• codex研究CLI参考
• 法典研究箱参考
• 全局CLI工作流程
• Rust技能套件
• 记忆指导建议
• Codex提示库

对于本地实时提供商测试，请复制 .env.example 对于一个未被追踪的人 .env 和 在运行提供者命令之前，将其导出到shell中。

每种技能都存在 skills// 并且被设计为：

• 自足 （说明+可选脚本/资产）
• 可发现的 （清晰的元数据+可预测的布局）
• 可包装 （可以作为 .skill ZIP存档）

仓库布局

skills/
  /
    SKILL.md              # required (YAML frontmatter + instructions)
    references/           # optional (docs to load on demand)
    scripts/              # optional (deterministic helpers)
    assets/               # optional (templates/snippets)
    templates/            # optional (scaffolds)
  dist/                   # local .skill bundles (ZIP; gitignored)
crates/
  codex-dev-core/         # Shared task capsule contracts and read-model helpers
  codex-dev/              # Rust CLI for local task capsules, policy gates, and development evidence
  codex-dev-tui/          # Optional Ratatui workbench for codex-dev capsules
  codex-research/         # Rust CLI for evidence-first research helpers
docs/
  index.md                # documentation portal
  architecture/           # system design
  guides/                 # onboarding and setup
  reference/              # CLI, crate, skill, and template references
  cookbooks/              # operator-grade workflows
  prompts/                # copy-paste Codex prompts
  runbooks/               # validation, troubleshooting, maintenance
tools/
  bootstrap/              # repo bootstrap pack renderer
  eval/                   # offline skill/subagent eval runner
  docs/                   # documentation checks
  skill/                  # skill validation and packaging helpers
subagents/
  codex/                  # tracked global roles, public overlays, and sync helpers

研究、子代理和操作栈

主系统结合了研究助手、可重用的子代理和开发 操作层：

• deep-researcher：与Focus Six子代理进行深度引用研究的技能

包。

• codex-research：Rust CLI用于规划、提供者路由、Context7 REST、，

GitHub REST、获取探测、Firecrawl调用、证据分类账、报告， 打包、缓存、医生和撤离。

• codex-dev-core：任务胶囊的共享合约/读取模型机箱，

验证、呈现摘要、技能清单、任务索引、编排运行 预测、策略清单数据和PR证据快照。

• codex-dev：本地任务胶囊生命周期的当前CLI，结构化

证据附加器、子计划/结果/综合捕获、编排 运行验证、回购本机策略门、只读本地工作站 准备状态检查和PR证据捕获。视情况而定 codex-dev-core 和 将Clap解析和进程执行保持在CLI边界。

• codex-dev-tui：可选的Ratatui工作台，用于读取 codex-dev 胶囊

JSON合约通过 codex-dev-core，包括技能操作面板 健康、任务索引、编排运行、PR代理阻止程序和下一步操作， 没有政策逻辑。

• skill_subagent_eval.py：离线评估实验室，获取完整技能目录，

技能资产、OpenAI代理元数据、子代理模板、角色契约和 计划器预设。

• render_bootstrap_pack.py：用于播种新种子的清单支持的引导包

带有代理指导和验证文档的repos。

• subagent-creator：自定义Codex代理模板的助手技能和CLI。
• subspawn：严格的子代理委托策略，带有计划员生成的提示

在下一次工作合成之前必须等待。

从受信任的签出构建并安装本地CLI：

cargo build -p codex-research
cargo build -p codex-dev
cargo build -p codex-dev-tui
cargo install --path crates/codex-research --locked --force
cargo install --path crates/codex-dev --locked --force
cargo install --path crates/codex-dev-tui --locked --force
codex-research --json doctor
codex-dev --help
codex-dev-tui --help

从已安装的二进制文件生成shell补全和手册页：

codex-research completions zsh > /tmp/_codex-research
codex-dev completions zsh > /tmp/_codex-dev
codex-dev-tui completions zsh > /tmp/_codex-dev-tui
codex-research manpage > /tmp/codex-research.1
codex-dev manpage > /tmp/codex-dev.1
codex-dev-tui manpage > /tmp/codex-dev-tui.1

从源代码处吸烟开发CLI：

cargo build -p codex-dev
cargo build -p codex-dev-core
cargo build -p codex-dev-tui
cargo run -q -p codex-dev -- --help
# codex-dev:policy-manifest-smoke:start
cargo run -q -p codex-dev -- --json policy manifest --profile codex_dev
cargo run -q -p codex-dev -- --json policy explain --profile codex_dev
cargo run -q -p codex-dev -- --json policy manifest --profile full_local
cargo run -q -p codex-dev -- --json policy explain --profile full_local
# codex-dev:policy-manifest-smoke:end
cargo run -q -p codex-dev -- --json policy docs-check
cargo run -q -p codex-dev -- --json local doctor
cargo run -q -p codex-dev -- --json local status
cargo run -q -p codex-dev -- --json skills inventory
cargo run -q -p codex-dev -- --json task list
cargo run -q -p codex-dev -- --json research import-bundle --help
cargo run -q -p codex-dev -- --json orchestration verify --help
cargo run -q -p codex-dev -- --json pr plan --repo BjornMelin/dev-skills --number 25
cargo run -q -p codex-dev -- --json pr agent --help
cargo run -q -p codex-dev -- --json pr agent-action --help
cargo run -q -p codex-dev -- --json pr readiness --help

在中运行规范任务胶囊夹具 验证 更改编排时 计划/记录/关闭/验证行为。

要从任何目录进行发布切换和安全更新，请使用 全局CLI工作流 和 本地发布和供应链 小册子。 codex-dev-core 是一个库机箱，而不是已安装的二进制文件。

预览repo引导包：

tmp=$(mktemp -d)
cargo run -q -p codex-dev -- --json bootstrap status
cargo run -q -p codex-dev -- --json bootstrap plan --pack codex-agent-repo --out "$tmp/codex" --repo-name codex-smoke
python3 tools/bootstrap/render_bootstrap_pack.py --list
python3 tools/bootstrap/render_bootstrap_pack.py --pack codex-agent-repo --out "$tmp/codex" --repo-name codex-smoke --dry-run

安装深度研究代理：

python3 skills/deep-researcher/scripts/install_agents.py --target global --dry-run
python3 skills/deep-researcher/scripts/install_agents.py --target global

对于自定义子代理模板所有权、打包的回退副本、重复角色 验证和技能打包规则，请参阅 子代理模板.

技能目录

所有技能都存储在 skills/。每种技能的标准入口点是 它的 SKILL.md机器可读的自动化库存可通过以下方式获得 codex-dev --json skills inventory；下表仍然是面向人类的 目录。

运用这些技能

如何“安装”技能取决于代理运行时。通常，您需要磁盘上可用的技能文件夹，以便运行时可以读取 SKILL.md 以及（可选地）捆绑资源。

常见方法：

• 来源： 复制或符号链接 skills// 进入运行时的技能目录。
• 从捆绑包中： 使用一个 .skill 捆绑包（ZIP）并使用运行时/注册表工具安装它（例如通过 ).

验证和包装

此仓库包括轻量级验证和打包助手 tools/skill/.

验证技能目录：

python3 tools/skill/quick_validate.py skills/

将技能打包 skills/dist/.skill:

python3 tools/skill/package_skill.py skills/ skills/dist

构建Rust CLI：

cargo build -p codex-dev
cargo build -p codex-dev-core
cargo build -p codex-dev-tui
cargo build -p codex-research

使用 docs/runbooks/validation.md 为了 规范验证矩阵和 docs/runbooks/local-release-supply-chain.md 对于经过审核的本地安装和发布基线。使用 docs/reference/distribution-surface-gates.md 在打开crates.io出版物之前，签署二进制文件，货物兽医，Tauri桌面， 或者Axum本地服务实现工作。README有意保留为门户 因此命令列表不会偏离运行手册。使用 docs/reference/subgent-templates.md 为了 子代理模板权限模型和重复角色期望。

Rust技能套件验证：

node skills/rust-expert/scripts/check-reference-links.mjs skills/rust-expert skills/rust-cli-clap skills/rust-tui-ratatui skills/rust-tauri-apps skills/rust-web-services skills/rust-mega-eng
node skills/rust-expert/scripts/check-trigger-evals.mjs skills/rust-expert skills/rust-cli-clap skills/rust-tui-ratatui skills/rust-tauri-apps skills/rust-web-services skills/rust-mega-eng

笔记：

• A. .skill 文件是一个ZIP存档，其中包含 /... 文件夹。

skills//... 是用于创建它的源树路径。

• 捆绑包在这里被视为构建工件（gitignored），旨在

通过发布资产/注册表发布。

贡献（对此回购）

• 保持技能入口点在 skills//SKILL.md.
• 放入长形材料 references/ 以及中的可执行助手 scripts/.
• 保持frontmatter最小化和规范兼容（验证器强制执行允许的密钥）。

许可证

此存储库可能包含不同许可证下的技能。检查每个技能目录中的许可证文件（例如 skills/vitest-dev/LICENSE)并遵循该特定技能的条款。