Community生产力与协作github.com

berkekcay/link-shortener-agent-ready

用于实现链接缩短器功能(自定义别名、点击计数器、过期时间等)或任何其他行为变更。引导用户先编写测试,进行最小化修改,运行 pytest 并总结。

link-shortener-agent-ready 是什么?

这是一个为 AI 代理(如 Claude Code、Cursor、Codex)设计的技能,专门用于实现基于 `docs/TASKS.md` 的链接缩短器功能。它适用于添加自定义别名、点击计数器、链接过期等特性,以及任何其他行为变更。该技能支持通过逐步流程确保代码质量:首先读取项目相关文档(`AGENTS.md`、任务文件、测试指南),然后检查现有代码,明确计划,编写一个失败测试,进行最小化实现,最后运行 pytest 并总结结果。它能有效地帮助开发者或 AI 代理在修改链接缩短器时保持一致性,避免破坏现有功能,并确保测试覆盖。该技能主要与 Python 项目和 pytest 测试框架配合使用,通过强制先编写测试,引导用户进行小而安全的变更。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/berkekcay/link-shortener-agent-ready/tree/HEAD/.claude/skills/implement-task

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

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

文档

实现一个链接缩短器任务

按顺序执行以下步骤。如果任务不明确或需要 AGENTS.md 中“向人询问”部分列出的内容,请停止并询问。

  1. 阅读。 打开 AGENTS.md、docs/TASKS.md 中选定的任务以及 tests/AGENTS.md。只处理这一个任务。

  2. 检查。 阅读 main.py(表格、encode() 函数、请求模型和两个路由)以及 tests/test_main.py。注意任务交互的任何内容,例如代码如何生成或数据库如何在运行之间共享。

  3. 说明计划。 在编辑之前,写下:

    • 期望的行为,包括成功和每种失败情况下的状态码和响应体;
    • 你将更改的文件;
    • 边界情况(空输入或异常输入,与现有代码的冲突,重复的值)。
  4. 编写一个失败的测试。 按照 tests/AGENTS.md 在 tests/test_main.py 中添加行为测试:至少一个成功案例和一个失败案例。运行它们并确认它们因正确的理由而失败(功能缺失,而非拼写错误):

    pytest tests/test_main.py -k <new_test_name>
    
  5. 进行最小化修改 在 main.py 中使测试通过。保持现有行为和响应形状。如果表格需要新列,请添加它以便现有的 links.db 仍然可用(或解释为什么必须重新创建)。

  6. 运行所有测试。

    pytest
    

    所有原始测试和新测试都必须通过。修复并重新运行直到全部通过。

  7. 总结 格式如下:

    任务:
    行为:
    修改的文件:
    添加的测试:
    pytest 结果:
    剩余风险:
    

相关技能