Skip to content
SweetRetryPublic

About

Retry's personal kit: agent skills, design language, and tech stack guidelines.

Resources

Stars

6 stars

Watchers

0 watching

Forks

Latest commit

 

History

338 Commits

Folders and files

Repository files navigation

Retry Kit

Retry 的个人工具箱:面向 Agent 的可复用 skill(AIGC 媒体类 skill 已拆到 sweet-media-kit)、个人设计语言,以及技术选型与工程约定。skill 放在 skills/,按职责领域分组;其余内容各占一个顶层目录。

目录

skills/            Agent skill,按职责领域分组
  engineering/     代码质量审查与工程任务拆解
  learning/        对话中的术语学习
  product/         产品需求文档
  web-design/      界面设计、文案、原型与交互审查
  specific/        特定框架工程实践
design/            Retry 个人设计语言(不是 skill)
conventions/       技术选型与工程约定(不是 skill)

Skills

Engineering

  • find-edgecases:审查重复、中断、超时、新旧版本并存等可达条件下的系统失效。
  • raise-ambition:动手前把任务抬高到真实结果,补齐顶尖做法、跨领域技巧、对抗视角与外部验收,改写成 prompt 后等确认。
  • simplify-code:审查并移除不改变行为的复杂度,顺带修复预期明确的 bug。
  • codex-review:从 Claude 手动调用本机 Codex CLI 审查改动,只读运行、追问续接同一会话以节省额度,并逐条核实 Codex 的发现。

Learning

  • name-domain-terms:用户用自己的话描述、逼近或误用专业名词时,主动说出术语、给出一句话定义与差别,之后沿用。

Web Design

  • sass-ux-writing:先校准 SaaS 产品的组织模型与业务场景,以克制专业的书面产品语体改写界面文案,统一领域词表,输出对照表。
  • design-md-creator:逐轮访谈品牌、设计规范与应用界面决策,视觉选择在可交互样张上比较,再创建或更新 design.md。
  • ui-prototyping:先改需求与动线,再用临时可交互原型比较尚未定案的 UI 方案或视觉取值;模板内置 shadcn 风格组件与 Alpine,改既有界面时以现状为基线候选。
  • ux-audit:审查体验质量,用代码与渲染盘点长期迭代造成的设计漂移,先预测再操作走查核心任务(最小惊讶),按理解、行动、反馈、恢复、专注、一致、信任、可达八个维度检验,报告严重度与防复发护栏。
  • sweet-mode:Tailwind + shadcn/ui 界面规范,层级、布局、表面、字体、尺寸稳定、交互反馈与动效的取值、禁令、验收与扫描脚本;面向原则,作为原型定案后实现的硬约束。

相邻能力的边界

任务 入口 按需加载
改写 SaaS 界面文案、统一领域词表 sass-ux-writing 自含语境校准与改写规则
在 Tailwind + shadcn/ui 项目中编写或修改界面,或需要界面规则与取值 sweet-mode 按改动读取层级、布局、表面、字体、稳定或交互 reference
设计新功能或改进既有界面:改需求、比动线与 UI 方案 ui-prototyping HTML 模板;比视觉取值时读取值模式 reference
审查界面或流程的可用性:一致性、设计漂移、信噪比、最小惊讶 ux-audit 盘点漂移读一致性 reference 并跑代码与渲染盘点脚本;逐维检验读维度 reference
沉淀品牌与设计规范 design-md-creator 新建/重排时读结构模板;封杀清单轮读套路候选
动手前抬高任务目标、定义外部验收 raise-ambition 自含流程
对话中说出用户正在描述的专业名词 name-domain-terms 自含流程

这些入口互不引用,也不默认串联;同一任务确实包含多类问题时再组合。find-edgecases 检查系统在可达扰动下的失效,simplify-code 检查保持行为不变的复杂度,两者保留独立入口。

外部 Skills(按需使用,不在本仓库手写维护)

以下能力的 source of truth 是各自上游;本仓库只记录其适用范围,不复制、改写或维护规则。

  • Vercel Web Design Guidelines:审查 UI 代码的 Web Interface Guidelines、accessibility、UX 与实现质量。
  • Emil Kowalski Skills:design engineering、动画设计、动画审查与 UI library 选择。
  • Matt Pocock Skills:可组合的工程工作流,覆盖需求对齐、调试、TDD、规格与架构改进。
  • Impeccable:面向 AI coding agent 的设计工作流,覆盖视觉 critique、a11y / responsive audit、motion 与浏览器迭代。

Design

design/ 是 Retry 的个人设计语言,不是 skill。

  • DESIGN.md:设计决策,包括气质、颜色、字体、布局、组件差异与交互取舍。
  • brand-kit/:值与资源。tokens.json 是 source of truth,globals.css 由 python3 design/brand-kit/generate-globals.py 生成,不手改。

Conventions

conventions/ 记录前端、后端、目录组织、可观测性、工具链与测试的约定,可机械检查的部分附 scripts/ 示范,入口见 conventions/README.md。视觉取值不在这里,归 design/。

维护约定

以下约定适用于 skills/;design/ 与仓库级规则见 AGENTS.md。

  • 每个 skill 使用独立目录,位于 skills/<领域>/<skill>/,目录名与 SKILL.md 中的 name 一致;name、display_name 和一级标题统一使用英文。
  • skill 专属的按需资料放在该 skill 的 references/。
  • 保持 skill 职责独立,避免通过目录分层掩盖能力重叠。
  • 显式调用策略按宿主配置:Claude Code 使用 SKILL.md 的 disable-model-invocation: true;Codex 使用 agents/openai.yaml 的 policy.allow_implicit_invocation: false。两者不能互相替代;修改后检查显式可调用、隐式不触发。
  • 用户反馈驱动的修改遵循 AGENTS.md 中的反馈闭环。

Claude Code

把 skills/<领域>/<skill>/ 整个目录复制或链接到项目级 .claude/skills/<skill>/ 或用户级 ~/.claude/skills/<skill>/,领域目录不参与安装路径。带有 disable-model-invocation: true 的 skill 不会被 Claude 自动加载,只能由用户通过 /skill-name 调用。

About

Retry's personal kit: agent skills, design language, and tech stack guidelines.

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages