Retry 的个人工具箱:面向 Agent 的可复用 skill(AIGC 媒体类 skill 已拆到 sweet-media-kit)、个人设计语言,以及技术选型与工程约定。skill 放在 skills/,按职责领域分组;其余内容各占一个顶层目录。
skills/ Agent skill,按职责领域分组
engineering/ 代码质量审查与工程任务拆解
learning/ 对话中的术语学习
product/ 产品需求文档
web-design/ 界面设计、文案、原型与交互审查
specific/ 特定框架工程实践
design/ Retry 个人设计语言(不是 skill)
conventions/ 技术选型与工程约定(不是 skill)
find-edgecases:审查重复、中断、超时、新旧版本并存等可达条件下的系统失效。raise-ambition:动手前把任务抬高到真实结果,补齐顶尖做法、跨领域技巧、对抗视角与外部验收,改写成 prompt 后等确认。simplify-code:审查并移除不改变行为的复杂度,顺带修复预期明确的 bug。codex-review:从 Claude 手动调用本机 Codex CLI 审查改动,只读运行、追问续接同一会话以节省额度,并逐条核实 Codex 的发现。
name-domain-terms:用户用自己的话描述、逼近或误用专业名词时,主动说出术语、给出一句话定义与差别,之后沿用。
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 检查保持行为不变的复杂度,两者保留独立入口。
以下能力的 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/ 是 Retry 的个人设计语言,不是 skill。
DESIGN.md:设计决策,包括气质、颜色、字体、布局、组件差异与交互取舍。brand-kit/:值与资源。tokens.json是 source of truth,globals.css由python3 design/brand-kit/generate-globals.py生成,不手改。
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 中的反馈闭环。
把 skills/<领域>/<skill>/ 整个目录复制或链接到项目级 .claude/skills/<skill>/ 或用户级 ~/.claude/skills/<skill>/,领域目录不参与安装路径。带有 disable-model-invocation: true 的 skill 不会被 Claude 自动加载,只能由用户通过 /skill-name 调用。