Ponytail社区与贡献指南从修规则文案到发布ClawHub技能包【免费下载链接】ponytailMakes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.项目地址: https://gitcode.com/GitHub_Trending/po/ponytailPonytail 是一个让 AI agent 像最懒的资深开发者一样思考的开源技能包项目——最好的代码是你根本没写的代码。它通过一份偷懒阶梯规则集YAGNI、优先复用、标准库优先让 Claude Code、Codex、Gemini CLI 等 20 多种 AI 编程助手生成的代码平均减少 54%。这篇文章面向想参与贡献的新手带你走通 Ponytail 项目两条最核心的社区贡献路径修正多平台同步的规则文案以及发布 ClawHub 技能包。一分钟了解 Ponytail 的规则体系Ponytail 的核心是一份阶梯规则agent 在写代码前逐级检查这功能需要存在吗项目里已经有了吗标准库能做吗……停在第一个成立的台阶上。规则文案的源头在根目录的 AGENTS.md其中第 1~7 级阶梯和懒惰但不粗心的安全例外信任边界校验、数据丢失防护、安全、无障碍是整个项目的灵魂条款。1. Does this need to exist? → 不需要就跳过YAGNI 2. Already in this codebase? → 复用别重写 3. Stdlib does it? → 用标准库 4. Native platform feature? → 用平台原生能力 5. Installed dependency? → 用已装依赖 6. One line? → 一行搞定 7. Only then: 最小可用实现由于要适配 Cursor、Windsurf、Cline、Copilot、Kiro、Qoder 等不同宿主同一份规则在仓库中维护了7 份拷贝如 .cursor/rules/、.windsurf/rules/、.github/copilot-instructions.md。各宿主对应关系详见 docs/agent-portability.md。贡献路径一修正规则文案并同步全部拷贝这是 Ponytail 最常见的贡献场景——某条规则措辞不当、某条安全例外被误删都需要改一处、同步七处。标准操作流程克隆仓库git clone https://gitcode.com/GitHub_Trending/po/ponytail修改权威文案先改 skills/ponytail/SKILL.md运行时真相源和 AGENTS.md再把改动同步到 7 份宿主拷贝本地验证运行项目自带的两个守卫脚本node scripts/check-rule-copies.js npm test守卫脚本在检查什么scripts/check-rule-copies.js 会逐字节对比 7 份宿主拷贝与AGENTS.md自动剥离各宿主的 frontmatter任何漂移都会让脚本退出码非零由于SKILL.md比紧凑版更长、无法整文件比对脚本用不变量金丝雀兜底check-rule-copies.js 中的INVARIANTS列表钉死了信任边界输入校验防止数据丢失安全无障碍等关键短语原文改写一旦丢失这些词就会报警scripts/check-versions.js 则确保 8 个声明版本的文件五大宿主生态的插件清单 两个package.json版本号完全一致——这是 v4.8.0 时清单集体滞留旧版本的真实事故issue #260后加上的防线。提交前 CI 会原样跑一遍.github/workflows/test.yml 依次执行规则拷贝检查、版本一致性检查、npm test全量测试测试位于 tests/含行为、命令、钩子、技能包等 14 个测试文件。本地绿了再发 PR是 Ponytail 社区的基本礼仪。贡献路径二构建并发布 ClawHub 技能包Ponytail 的 OpenClaw / ClawHub 技能包不是手写的而是从skills/生成的这是第二条常见的贡献场景改了技能后需要重新生成并发布。三步构建发布流程重新生成修改 skills/ 下任一技能后运行node scripts/build-openclaw-skills.js脚本会把 6 个技能ponytail、review、audit、debt、gain、help生成到 .openclaw/skills/正文逐字复制、仅重写 frontmatterdescription压缩到 160 字符以内的单行。测试套件 tests/openclaw-skills.test.js 会在提交副本过期时直接失败防止改了源、忘了生成。预览发布先登录一次注册表再干跑一遍看将要发布的内容clawhub login node scripts/publish-openclaw-skills.js --dry-run正式发布node scripts/publish-openclaw-skills.jsscripts/publish-openclaw-skills.js 会自动从 package.json 读取当前版本目前是 4.9.0让 ClawHub 上的技能包与仓库版本严格同步脚本还会自动扫描.openclaw/skills/下的所有技能目录无需手工维护技能清单。贡献前自检清单 ✅检查项命令 / 文件拦截的问题规则拷贝同步node scripts/check-rule-copies.js7 份宿主文案漂移、安全例外丢失版本号一致node scripts/check-versions.js插件清单版本滞后#260 事故全量测试npm test钩子、命令、技能包行为回归OpenClaw 副本新鲜度tests/openclaw-skills.test.js技能改后未重新生成快速文件导航 ️规则源头AGENTS.md 运行时技能源skills/ponytail/SKILL.md守卫脚本scripts/check-rule-copies / check-versions / build / publish / uninstall宿主适配文档docs/agent-portability.md、docs/platform-native.md基准测试与效果报告benchmarks/行为示例日期选择器等幸存案例examples/Ponytail 团队的理念和它的代码一样简洁删除优于新增无聊优于聪明。你的第一次贡献很可能就是让某个平台拷贝上的一行规则措辞更准确——跑通上面两个守卫脚本、看着 CI 变绿的那一刻你就已经完成了这个项目所定义的全部发布流程。【免费下载链接】ponytailMakes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.项目地址: https://gitcode.com/GitHub_Trending/po/ponytail创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Ponytail社区与贡献指南：从修规则文案到发布ClawHub技能包
Ponytail社区与贡献指南从修规则文案到发布ClawHub技能包【免费下载链接】ponytailMakes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.项目地址: https://gitcode.com/GitHub_Trending/po/ponytailPonytail 是一个让 AI agent 像最懒的资深开发者一样思考的开源技能包项目——最好的代码是你根本没写的代码。它通过一份偷懒阶梯规则集YAGNI、优先复用、标准库优先让 Claude Code、Codex、Gemini CLI 等 20 多种 AI 编程助手生成的代码平均减少 54%。这篇文章面向想参与贡献的新手带你走通 Ponytail 项目两条最核心的社区贡献路径修正多平台同步的规则文案以及发布 ClawHub 技能包。一分钟了解 Ponytail 的规则体系Ponytail 的核心是一份阶梯规则agent 在写代码前逐级检查这功能需要存在吗项目里已经有了吗标准库能做吗……停在第一个成立的台阶上。规则文案的源头在根目录的 AGENTS.md其中第 1~7 级阶梯和懒惰但不粗心的安全例外信任边界校验、数据丢失防护、安全、无障碍是整个项目的灵魂条款。1. Does this need to exist? → 不需要就跳过YAGNI 2. Already in this codebase? → 复用别重写 3. Stdlib does it? → 用标准库 4. Native platform feature? → 用平台原生能力 5. Installed dependency? → 用已装依赖 6. One line? → 一行搞定 7. Only then: 最小可用实现由于要适配 Cursor、Windsurf、Cline、Copilot、Kiro、Qoder 等不同宿主同一份规则在仓库中维护了7 份拷贝如 .cursor/rules/、.windsurf/rules/、.github/copilot-instructions.md。各宿主对应关系详见 docs/agent-portability.md。贡献路径一修正规则文案并同步全部拷贝这是 Ponytail 最常见的贡献场景——某条规则措辞不当、某条安全例外被误删都需要改一处、同步七处。标准操作流程克隆仓库git clone https://gitcode.com/GitHub_Trending/po/ponytail修改权威文案先改 skills/ponytail/SKILL.md运行时真相源和 AGENTS.md再把改动同步到 7 份宿主拷贝本地验证运行项目自带的两个守卫脚本node scripts/check-rule-copies.js npm test守卫脚本在检查什么scripts/check-rule-copies.js 会逐字节对比 7 份宿主拷贝与AGENTS.md自动剥离各宿主的 frontmatter任何漂移都会让脚本退出码非零由于SKILL.md比紧凑版更长、无法整文件比对脚本用不变量金丝雀兜底check-rule-copies.js 中的INVARIANTS列表钉死了信任边界输入校验防止数据丢失安全无障碍等关键短语原文改写一旦丢失这些词就会报警scripts/check-versions.js 则确保 8 个声明版本的文件五大宿主生态的插件清单 两个package.json版本号完全一致——这是 v4.8.0 时清单集体滞留旧版本的真实事故issue #260后加上的防线。提交前 CI 会原样跑一遍.github/workflows/test.yml 依次执行规则拷贝检查、版本一致性检查、npm test全量测试测试位于 tests/含行为、命令、钩子、技能包等 14 个测试文件。本地绿了再发 PR是 Ponytail 社区的基本礼仪。贡献路径二构建并发布 ClawHub 技能包Ponytail 的 OpenClaw / ClawHub 技能包不是手写的而是从skills/生成的这是第二条常见的贡献场景改了技能后需要重新生成并发布。三步构建发布流程重新生成修改 skills/ 下任一技能后运行node scripts/build-openclaw-skills.js脚本会把 6 个技能ponytail、review、audit、debt、gain、help生成到 .openclaw/skills/正文逐字复制、仅重写 frontmatterdescription压缩到 160 字符以内的单行。测试套件 tests/openclaw-skills.test.js 会在提交副本过期时直接失败防止改了源、忘了生成。预览发布先登录一次注册表再干跑一遍看将要发布的内容clawhub login node scripts/publish-openclaw-skills.js --dry-run正式发布node scripts/publish-openclaw-skills.jsscripts/publish-openclaw-skills.js 会自动从 package.json 读取当前版本目前是 4.9.0让 ClawHub 上的技能包与仓库版本严格同步脚本还会自动扫描.openclaw/skills/下的所有技能目录无需手工维护技能清单。贡献前自检清单 ✅检查项命令 / 文件拦截的问题规则拷贝同步node scripts/check-rule-copies.js7 份宿主文案漂移、安全例外丢失版本号一致node scripts/check-versions.js插件清单版本滞后#260 事故全量测试npm test钩子、命令、技能包行为回归OpenClaw 副本新鲜度tests/openclaw-skills.test.js技能改后未重新生成快速文件导航 ️规则源头AGENTS.md 运行时技能源skills/ponytail/SKILL.md守卫脚本scripts/check-rule-copies / check-versions / build / publish / uninstall宿主适配文档docs/agent-portability.md、docs/platform-native.md基准测试与效果报告benchmarks/行为示例日期选择器等幸存案例examples/Ponytail 团队的理念和它的代码一样简洁删除优于新增无聊优于聪明。你的第一次贡献很可能就是让某个平台拷贝上的一行规则措辞更准确——跑通上面两个守卫脚本、看着 CI 变绿的那一刻你就已经完成了这个项目所定义的全部发布流程。【免费下载链接】ponytailMakes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.项目地址: https://gitcode.com/GitHub_Trending/po/ponytail创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考