Community写作与编辑github.com

S3n0001/agent-skills

公开的、即取即用的Agent技能,专为严谨的软件工程工作流打造。

agent-skills 是什么?

Ponytail 是一种应用于编码的“选择加入”极简模式(opt-in minimalism)。它的核心理念是“懒惰意味着高效,而非粗心”:首先理解真实流程,然后将解决方案最小化。该技能默认仅对当前任务启用**完整**强度,并支持用户明确指定的 `lite`、`full` 或 `ultra` 模式,当用户请求“正常模式”时则停止。它提供了一套“阶梯式”决策路径(从“是否需要存在”到“编写最少新代码”),指导开发者优先复用现有代码、标准库或原生平台功能。此外,Ponytail 还强调“保持变更真正微小”,通过修复共享归属点、优先删除而非增加、避免过度工程化等方式实现。该技能适用于任何需要严谨、高效编码的 AI 编码代理(如 Claude Code、Cursor),尤其适合那些希望减少臃肿、专注于交付最低限度正确代码的开发团队。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add S3n0001/agent-skills

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Ponytail

对编码应用一种选择加入的极简模式。懒惰意味着高效,而非粗心:先理解真实流程,然后将解决方案最小化。默认仅对当前任务启用完整强度。当明确指定时,遵循 lite、full 或 ultra 模式,并在用户请求正常模式时停止。

攀爬阶梯

停在第一个完全满足需求的阶梯上:

  1. 它是否需要存在? 跳过推测性工作。
  2. 代码库中是否已有它? 搜索并重用其所属的辅助函数、类型、模式或接缝。
  3. 标准库能否解决它? 使用标准库。
  4. 原生平台特性能否解决它? 优先使用 HTML、CSS、数据库、框架或操作系统行为,而非自定义代码。
  5. 已安装的依赖能否解决它? 重用它;不要为了几行清晰的代码而添加一个包。
  6. 一个可读的局部表达式能否解决它? 保持局部化。
  7. 只有在此之后: 编写正确的最小新代码。

阶梯遵循理解,而非取代理解。阅读任务和仓库说明,追踪真实的调用方和消费者,并在选择阶梯前确定事实来源。

保持变更真正微小

  • 在共享的归属接缝处修复根本原因。公共路径中的一行保护比在每个调用方中打补丁更小。
  • 保留所有明确的需求以及可触及的安全、隐私、可访问性、数据完整性、错误处理和兼容性不变项。
  • 优先删除而非增加,优先使用平淡代码而非巧妙代码。
  • 避免单实现接口、单产品工厂、推测性配置、平行框架、“为了以后”的脚手架,以及未经测量需求的新依赖。
  • 使用最少的文件产生一个连贯、可读的结果。不要强行写成一行,从而隐藏行为或将复杂性转移到别处。
  • 当两个小型解决方案等价时,优先选择边界行为更安全、所有权成本更低的那个。
  • 使用 ponytail: 注释来标记一个有实际上限的故意简化,注释中需命名该上限及其升级触发条件。

一个复杂的请求可能有一个更简单的等价路径。使用它并用一行解释替换理由,但绝不能为了减少差异而放弃需求。

按比例验证

未经证明的懒惰变更是不完整的。遵循现有仓库的测试惯例:

  • 非平凡逻辑(如分支、循环、解析器或涉及金钱/安全的路径)至少要有一个针对性的可运行检查。
  • 仅针对实质上不同的风险或验收条件添加更多检查。
  • 不要为单一变更引入测试框架。
  • 当现有覆盖已能证明时,平凡的单个一行代码不需要新测试。

设置强度

级别行为
lite构建所要求的内容,并在一行内命名更懒惰的等价方案。
full强制执行阶梯;优先选择复用、标准库、原生行为以及最短的可读正确差异。
ultra质疑推测性需求,首先尝试删除,仅交付已证明的最小需求。

用户需求和安全性不变式始终高于强度设置。

简要报告

首先说明交付的代码或结果。然后用最多三行简要说明跳过了什么以及添加它的条件,除非用户明确要求报告或讲解。

模式:[结果] -> 跳过:[X];当[Y]时添加。

Ponytail 管理的是构建什么,而非任务是否被理解或所需证据是否被报告。最短的正确、可读路径是正确路径。

相关技能