开发技能
可重用的版本化集合 代理技能 (根据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// 并且被设计为:
- 自足 (说明+可选脚本/资产)
- 可发现的 (清晰的元数据+可预测的布局)
- 可包装 (可以作为
.skillZIP存档)
仓库布局```
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:```bash
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补全和手册页:```bash
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:```bash
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引导包:```bash
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
安装深度研究代理:```bash
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;下表仍然是面向人类的
目录。
| 技能 | 描述 | 来源 |
|---|---|---|
agents-md-maintainer |
耐用 AGENTS.md 用于决定回购指导在实施后何时应更改的维护规则。 |
技能/代理md维护者/SKILL.md |
ai-sdk-agents |
AI SDK v6+代理 ToolLoopAgent:循环控制、动态工具和代理工作流。 |
技能/ai-sdk代理/SKILL.md |
ai-sdk-core |
AI SDK核心:文本/结构化输出、工具、MCP、嵌入/重排序、中间件、遥测。 | 技能/ai-sdk-core/技能.md |
ai-sdk-ui |
使用AI SDK React进行聊天和生成UI(useChat、持久性、流媒体、后端)。 |
技能/ai sdk ui/SKILL.md |
aws-architecture |
AWS架构:服务选择、边界、推出和验证。 | skills/aws架构/SKILL.md |
browser-workbench-setup |
Bootstrap浏览器/UI QA:Playwright交互式初级,代理浏览器烟雾,身份验证和本地约定。 | 技能/浏览器工作台设置/SKILL.md |
bun-audit |
Bun第一个审计/修复路由器(委托给中的共享引擎 bun-dev). |
技能/面包审计/SKILL.md |
bun-dev |
Bun开发和运行时:PM、锁文件、monorepos、测试/构建、TypeScript、Vercel Bun运行时。 | skills/bun dev/SKILL.md |
caveman-compress |
压缩文档和散文以减少标记,同时保留内容、代码、URL和结构。 | 技能/洞穴人压缩/SKILL.md |
codex-sdk |
Codex SDK/CLI:JSONL线程、MCP、多代理编排、SQLite内存、沙盒模式。 | 技能/代码sdk/SKILL.md |
codex-utils |
Codex会议实用程序:计划、风险编辑前的简短MCQ、图像、网络/MCP发现、并行工具使用。 | 技能/codex实用程序/SKILL.md |
commit |
在语义、可审查的小组中进行阶段和提交。 | 技能/承诺/SKILL.md |
context7-research |
通过Context7 MCP(版本特定、迁移、主要来源)进行的库/API文档研究。 | 技能/情境7研究/SKILL.md |
convex-audit |
审计凸后端:模式、安全性、运行时边缘、迁移、函数表面风险。 | 技能/凸审计/SKILL.md |
convex-best-practices |
生产凸:组织、查询、验证、TypeScript、错误、设计哲学。 | 技能/凸最佳实践/SKILL.md |
convex-component-adoption-planner |
研究凸形分量与实时图;问答得分;采用或拒绝包(PLAN.md,提示)。 |
技能/凸组件采用规划师/SKILL.md |
convex-feature-spec |
Convex-first功能规范:模型、API、推出、验证(非实施审核)。 | 技能/凸特征规范/SKILL.md |
dash-audit |
审计达世币应用程序:回调、状态、布局、可访问性、达世币特定的用户体验。 | 技能/破折号审核/SKILL.md |
deep-researcher |
深入引用Codex网站、Context7 API、GitHub、源代码、渲染页面、Firecrawl和证据分类账的研究。 | 技能/深度研究员/SKILL.md |
dmc-best-practices |
DMC+Dash最佳实践:架构、回调、样式、性能、主题。 | 技能/dmc最佳实践/SKILL.md |
dmc-py |
Dash Mantine Components v2.x:主题化、回调(模式匹配、客户端)、页面、图表、组件。 | 技能/dmc py/SKILL.md |
docker-architect |
Docker/Compose:Dockerfiles、Compose、CI、安全强化、审计。 | 技能/docker架构师/SKILL.md |
docs-align |
实施后文档对齐:漂移检测、ADR、规范、README, AGENTS.md. |
技能/文档对齐/SKILL.md |
gh-deps-intel |
Monoreps的JS/TS+Python依赖关系:过时的检查、发布/更改日志→ Markdown+JSON。 | 技能/gh-deps intel/SKILL.md |
gh-pr-review-fix |
使用最少的已验证修复程序(不是本地审查文件)端到端解决GitHub PR审查线程。 | 技能/gh-pr审查修复/SKILL.md |
grill-me |
通过详尽的问答对计划或设计进行压力测试,直到决策树清晰为止。 | 技能/烧烤我/SKILL.md |
langgraph-multiagent |
LangGraph/LangChain多代理:监督、切换、RAG、内存、护栏、迁移。 | 技能/语言多代理/SKILL.md |
new-branch |
首先创建一个传统的、对语义友好的分支,然后计划工作和PR | 技能/新分支/SKILL.md |
notebook-ml-architect |
ML笔记本:泄漏、可重复性、重构、模块化流水线、笔记本→脚本。 | 技能/笔记本电脑ml架构师/SKILL.md |
opensrc |
使用 opensrc CLI用于包内部、版本差异和升级审核。 |
skills/opensrc/SKILL.md |
opensrc-inspect |
本地 opensrc 用于依赖性/上游源代码检查的快照(不是一般的web研究)。 |
skills/opensrc inspect/SKILL.md |
platform-architect |
Next.js、Expo、Converx、monorepos的全栈/原生:检测、规划、repo验证。 | 技能/平台架构师/SKILL.md |
pytest-dev |
pytest:夹具、薄片、覆盖率、速度、CI分片和调谐。 | skills/pytest dev/SKILL.md |
repo-context-builder |
构建 REPO_CONTEXT.md 和 REVIEW_BRIEF.md 为未来的移交奠定基础。 |
技能/仓库上下文生成器/SKILL.md |
repo-docs-align |
跨堆栈将所有仓库文档同步到代码和工作流(AGENTS.md、ADR、运行手册等)。 |
技能/仓库文档对齐/SKILL.md |
repo-modernize-upgrade-audit |
回购和单回购依赖关系现代化、漏洞修复和框架感知升级审计。 | 技能/仓库现代化升级审计/SKILL.md |
review-remediation |
修复本地审查记录,验证首次分流;不包括托管的GitHub PR审查循环。 | 技能/复习复习/SKILL.md |
rust-cli-clap |
Rust CLI和Clap命令设计:解析器、输出契约、测试、打包。 | 技能/铁锈cli clap/SKILL.md |
rust-expert |
核心Rust工程路由器,用于所有权、异步、板条箱、测试、性能和安全。 | 技能/防锈专家/SKILL.md |
rust-mega-eng |
明确的Rust架构编排器,用于广泛的多机箱策略和发布计划。 | 技能/铁锈mega-eng/SKILL.md |
rust-tauri-apps |
Tauri v2 Rust应用程序后端:命令、安全IPC、功能、捆绑、分发。 | 技能/信任tauri应用程序/SKILL.md |
rust-tui-ratatui |
Rust终端UI架构,包括Ratatui、交叉项事件循环、快照和用户体验。 | 技能/生锈tui ratatui/技能.md |
rust-web-services |
生产Rust HTTP服务,包括Axum、Tokio、Tower、SQLx、跟踪和关闭。 | 技能/信任web服务/SKILL.md |
ship-branch |
语义提交、推送和打开PR main 具有传统的标题和正文。 |
技能/船舶分支/SKILL.md |
signr-pr-closure-loop |
签名风格的PR关闭:审查线程、CI、Expo/EAS、Vercel/Turborepo、文档、保姆以准备合并。 | 技能/签名pr闭环/SKILL.md |
sentry-cli-fix-issues |
修复CLI证据中的哨兵问题:问题、事件、跟踪、日志、回放、Seer、隐私和验证。 | 技能/哨兵cli修复问题/SKILL.md |
sentry-triage-to-pr |
对未解决的哨兵问题进行排名,对PR大小的修复进行分组,呈现GitHub问题计划,并计划子网格工作树。 | 技能/哨兵分流到pr/SKILL.md |
streamdown |
Streamdown:用于AI UI、Shiki/KaTeX/Mermaid、remend、强化的流式降价。 | 技能/流/技能.md |
streamlit-master-architect |
Streamlit:重播/状态、缓存/片段、AppTest、组件v2、安全、Playwright E2E。 | 技能/流光大师级建筑师/SKILL.md |
subagent-creator |
创建、验证、安装、区分、同步和冒烟测试Codex自定义子代理TOML角色包。 | 技能/子代理创建者/SKILL.md |
subspawn |
严格的等待和证据优先的综合限制了食品法典委员会的次级代理代表团。 | 技能/子技能/技能.md |
supabase-ts |
使用Next/React/TS:SSR认证、RLS、存储、实时、边缘功能、pgvector、部署。 | 技能/技能/技能.md |
taste-metaskill |
将前端UI工作路由到专注的视觉品味参考(高级、独特、反通用)。 | 技能/味觉技能/技能.md |
technical-writing |
内部工程文档:规范、架构、运行手册、API参考资料和变更日志。 | 技能/技术写作/SKILL.md |
upgrade-pack-generator |
回购本地升级包 .agents/plans/upgrade/ (剧本、提示、清单)。 |
技能/升级包生成器/SKILL.md |
vitest-dev |
TypeScript+Next.js的Vitest:稳定的套件、快速的本地+CI、分片。 | skills/vitest dev/SKILL.md |
zod-v4 |
Zod v4:模式、v3迁移、错误、JSON模式/OpenAPI、框架挂钩。 | 技能/zod-v4/技能.md |
运用这些技能
如何“安装”技能取决于代理运行时。通常,您需要磁盘上可用的技能文件夹,以便运行时可以读取 SKILL.md 以及(可选地)捆绑资源。
常见方法:
- 来源: 复制或符号链接
skills//进入运行时的技能目录。 - 从捆绑包中: 使用一个
.skill捆绑包(ZIP)并使用运行时/注册表工具安装它(例如通过 ).
验证和包装
此仓库包括轻量级验证和打包助手 tools/skill/.
验证技能目录:```bash
python3 tools/skill/quick_validate.py skills/
将技能打包 `skills/dist/.skill`:```bash
python3 tools/skill/package_skill.py skills/ skills/dist
构建Rust CLI:```bash
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技能套件验证:```bash
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)并遵循该特定技能的条款。
