davidondrej-skills 路线图与社区：如何编写并推送你的 Agent Skill 到 GitHub

davidondrej-skills 路线图与社区如何编写并推送你的 Agent Skill 到 GitHub【免费下载链接】skillsaccess to david ondrejs personal agent skills项目地址: https://gitcode.com/gh_mirrors/skills46/skillsdavidondrej-skills是开发者 David Ondrej 开源的 Agent Skill 仓库汇集了他日常使用的 40 多个可复用 AI 智能体技能覆盖编码代理编排、技能创作、网络研究与运维设置等场景。每个技能把一段工作流打包成SKILL.md让 AI 代理在需要时自动加载执行。这篇文章将带你完整走一遍流程从零理解 Agent Skill动手编写自己的技能并最终把它推送到 GitHub。 什么是 Agent SkillAI 代理能力的最小构建块Agent Skill 本质上就是一个文件夹里面有一份必需的SKILL.mdYAML 元数据 Markdown 指令外加可选的脚本、参考文档和资源文件。完整的创作规范写在 skills/skill-authoring/effective-agent-skills/SKILL.md 中结构如下my-skill/ ├── SKILL.md # 必需元数据 指令 ├── scripts/ # 可选可执行脚本 ├── references/ # 可选按需加载的详细文档 └── assets/ # 可选模板、字体等静态文件它最聪明的设计是渐进式加载Progressive Disclosure分三级消耗上下文级别加载时机内容1️⃣ 发现始终在上下文中namedescription约 100 token2️⃣ 激活请求匹配时完整的SKILL.md正文3️⃣ 执行按需references/文档或运行scripts/正因为第 1 级只加载名字和描述description 就是技能的路由合同——如果技能没被触发95% 的问题是描述写得不好而不是正文。️ 仓库路线图5 大技能分类一览技能按类别文件夹组织在 README.md 中说明的skills/目录下这个结构本身就是你学习技能该放哪的最佳路线图分类用途代表技能skills/agent-orchestration/运行、调度、协调 AI 编码代理codex-subagent、goal-loopskills/skill-authoring/创建、改进、分发、发布技能push-skills、effective-agent-skillsskills/research-and-web/网络搜索、深度研究、浏览器操作deepapi、deep-researchskills/thinking-and-docs/结构化思考、教学、文档沉淀short、teachskills/ops-and-setup/机器、服务器、安全与工具设置anti-sleep、repo-sync每个技能文件夹都是自包含的单元——想理解某个场景的最佳实践直接读对应分类下的SKILL.md即可。✍️ 9 步写出你的第一个 Agent Skillskills/skill-authoring/effective-agent-skills/SKILL.md 总结了一套经过实战检验的创作流程找到缺口—— 让代理跑真实任务它反复失败或反复被追问的地方就是技能候选选择模式—— 能力原语需要新工具逻辑放脚本里还是流程原语需要方法论纯指令即可先写描述—— 包含三要素做什么一句话何时用用户会说的触发词与相似技能的差异点写最小可用正文—— 够用即可测试暴露缺口再补充细节下沉—— 正文变长就把内容移到references/测试触发—— 不点名技能地提问看它是否自动激活测试执行—— 显式调用检查输出是否正确对抗测试—— 让另一个 LLM 挑刺什么边缘情况会击穿这个技能版本控制—— 把技能当代码对待打标签、开分支、做评审一条描述的好例子来自本仓库的 short 技能手动调用的技能强制代理压缩上一条回答——去掉填充词、简化措辞。当用户说 short、too long、tl;dr 时使用。注意描述只写是什么和何时用绝不在描述里复述完整步骤否则代理会照着摘要执行而跳过正文。 分发并推送你的 Agent Skill 到 GitHub一键克隆仓库git clone https://gitcode.com/gh_mirrors/skills46/skills把新技能放入对应分类文件夹例如skills/skill-authoring/my-skill/并确保SKILL.md的name字段与文件夹名完全一致小写字母和连字符最长 64 字符。让多个代理都能发现你的技能如果你的工作区同时跑 Codex、Claude Code、Pi 等多个代理需要把技能分发到各自的技能目录。skills/skill-authoring/distribute-skill-to-all-agents/SKILL.md 给出了 4 个标准位置和软链接技巧以~/.agents/skills/为规范源其余位置通过符号链接自动同步只有个别代理需要手动复制最后用字节数比对验证 4 处内容完全一致。推送到 GitHub 的规范流程本仓库的发布机制是私有仓库作为规范源推送到main后由流水线自动同步到经过脱敏的公开镜像见 push-skills/SKILL.md。对社区贡献者而言核心原则同样适用只在明确请求时才提交和推送编辑技能不等于发布授权推送前用git diff复查所有待推送的提交绝不强制推送推送后验证公开文件内容——流水线可能改写或省略内容绿勾和文件存在都不等于发布成功✅ 发布前安全检查清单仓库把技能安全当作头等大事提交前对照 Ship checklist 自查name与文件夹名一致描述含做什么 何时用 差异点文件夹内没有 README、CHANGELOG 等人看的文档技能是给代理读的只使用相对路径无时效性信息截至 2024 年这类内容会迅速过期脆弱、易错的步骤写成了脚本而不是靠提示词赌运气弱模型和强模型都测过更强的模型会原谅模糊的技能弱模型才暴露问题使用第三方技能前更要走一遍 安全清单逐文件审查、检查脚本的外联网络调用、警惕提示注入和名称仿冒先在沙箱里跑。本仓库还自带一道防线——全局命令守卫 hooks/deny-dangerous.sh 配合 65 条危险命令正则黑名单 hooks/dangerous-patterns.txt在代理执行 shell 命令前拦截rm -rf /、磁盘格式化等灾难性操作。 社区与路线图从一个技能到一支代理团队这个仓库的路线图不是功能列表而是技能生态的演进全局规则沉淀—— 根目录的 AGENTS.md 定义了简洁沟通、禁止乱加依赖、多代理协作互不干扰等社区约定是每个贡献者应该先读的文件组合优于捆绑—— 一个技能只做一件事更大的工作流靠技能组合完成如 align → spec → build → verify并通过仓库级上下文文件协调跨厂商可移植—— Agent Skills 是开放标准同一份文件可运行在 Codex、Claude Code 等多个客户端Codex 用户还可通过agents/openai.yaml单独控制隐式调用策略示例见 codex-subagent下一步行动从 effective-agent-skills 的 9 步流程开始挑一个你每周都要重复的 AI 工作流把它变成你的第一个技能推送上去——让全世界的代理都能用上它。【免费下载链接】skillsaccess to david ondrejs personal agent skills项目地址: https://gitcode.com/gh_mirrors/skills46/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考