规格、任务拆解、小步实现与证据审查

Addy Osmani Agent Skills

从规格到逐项交付

Addy Osmani 的工程工作流集合，用明确规格、小任务、测试与审查组织 AI 编程。九条命令连接不同阶段；你提供项目上下文、批准关键选择，再用实际文件、测试和测量结果判断是否完成。

作者 Addy Osmani

安装与上手查看 GitHub
Addy Osmani Agent Skills：从规格到逐项交付 项目图片

作者列出的使用环境

  • Claude Code
  • Codex
  • Cursor
  • Gemini CLI
  • GitHub Copilot
  • OpenCode
  • Windsurf
  • Kiro
  • Antigravity
GitHub Star
111,741
版本
0.6.14
资料核对
分类
工程开发

新功能从规格开始，已有改动从证据检查开始

第一次可以沿“规格 → 批准 → 计划 → 批准 → 单项构建”走完一轮。成熟工程更适合先审查当前差异、补齐将要改动位置的测试，再逐步采用完整流程。

选一个任务，开始使用

在目标项目中打开 Claude Code，依次发送下方两条安装命令。确认插件与命令已加载后，选择一项任务；前三项有先后顺序，审查、性能与约束可以独立开始。

选择你当前要推进的工作

在现有订单项目中开始一个新功能。输入是代码、现有筛选与权限规则，以及你希望导出的内容；这一轮只形成规格，保存后需要你审阅。

  1. 在 Claude Code 内安装插件

    在 Claude Code 会话中逐条发送，先加入 HTTPS 市场，再安装插件。这两行不是普通终端命令。安装后确认插件启用和命令可见；下方示例统一带 /agent-skills: 前缀。

    /plugin marketplace add https://github.com/addyosmani/agent-skills.git
/plugin install agent-skills@addy-agent-skills
    查看作者安装说明

    先确认入口，再确认项目基线

    添加市场和安装插件是两步，请在 Claude Code 会话内逐条发送，不能粘进普通 shell。通过 /plugin 确认 agent-skills 已启用，并检查 /agent-skills:spec 等命令是否可见；必要时按客户端提示重新加载。再确认项目路径、测试命令与已有改动。只加入市场不代表插件已安装。

    查看作者的安装与交接说明

  2. 把这段话发给 AI

    以下是本站依据已核验文档编写的提示词，CSV 导出是编辑示例，并非作者案例或本站实测。替换成自己的功能与材料；前一步需要批准的内容，应先完成审阅再继续。

    /agent-skills:spec 为当前订单列表添加“导出筛选结果为 CSV” 先读项目说明、订单列表、筛选逻辑、权限边界和现有测试。目标是让用户导出自己当前可见且符合筛选条件的订单；沿用现有权限，不扩大数据访问范围。请先列出假设，询问尚未明确的导出字段、排序、空结果、数量上限、日期与金额格式、失败提示和 CSV 特殊字符处理。不要把待决定内容写成既定需求。规格应覆盖目标、真实可运行的项目命令、目录结构、现有代码风格、测试策略和操作边界，并写出可检查的成功条件。若根目录已有 SPEC.md，先确认是否属于本次工作，不覆盖其他工作的规格。把结果保存为根目录 SPEC.md，汇总开放问题后停下来等我批准；这一轮不拆实施计划、不写功能代码。

  3. 检查你拿到的结果

    • 根目录的 SPEC.md，能区分已决定的行为、现有约束与待确认问题。
    • 逐条检查“筛选结果一致、权限不扩大、空结果与失败有明确行为”等验收条件；命令应来自这个项目，而不是默认套用 npm test。
    • 确认保存的规格没有把未回答的问题悄悄补成决定，再明确批准或修改。此时还没有实现功能。
    查看这项任务的作者说明
进一步了解这个 Skill

Agent Skills 把软件开发中的工作方式写成可复用的步骤，由 Addy Osmani 发起维护。当前仓库包含 25 个 Skill、九条生命周期命令和四个审查角色。Skill 描述怎么做，命令负责进入一段流程，角色提供代码、测试、安全或网页性能的专门视角。它们由编程助手按需加载和执行，角色文件本身不会组成一个持续运行的工程团队。

这套集合最有辨识度的是产物之间的交接。规格先写清要做什么和怎样验收；计划再把它拆成能独立验证的小任务；构建一次完成一个任务，测试、验证并提交后再向前。SPEC.md、tasks/plan.md 和 tasks/todo.md 是本页采用的默认交接文件。换会话时应读这些文件和真实工程状态，而不是把上一轮“已完成”的聊天摘要当作新基线。

新项目可以从完整流程开始，已有项目则需要保护现有行为。作者的采用指南建议先理解约定、审查改动，并为即将修改的旧逻辑补测试，再扩展到规格与实施。安装不要求重排现有目录，也不应把这个技能仓库自己的 AGENTS.md 或 CLAUDE.md 复制过去；那些文件是给它自身的贡献者用的。

审查和质量约束承担不同工作。/review 从正确性、可读性、架构、安全和性能检查某次改动；/constraints 则把这个项目长期采用的标准写进 CONSTRAINTS.md，并对应到工具与运行阶段。仅有文字要求仍依赖助手遵守，真正的阻断能力取决于已接入的脚本、CI 和权限设置。阈值应有基线和理由，不能把示例数字直接当作所有工程的标准。

网页性能另有专门入口。/webperf 没有测量材料时只做源码分析，有报告或浏览器测量能力时才填入相应指标；实验室、真实用户与追踪数据要分别标注。源码可提示图片、脚本或请求方式的风险，却不能凭空算出用户的 LCP、INP 或 CLS。优化是否有效，要看条件一致的前后测量和功能回归。

本页选择 Claude Code 插件作为完整示例路径，并统一使用 /agent-skills: 前缀。安装其他客户端时应按各自入口调用 Skill，不能照搬这组命令。单条 Skill 安装还可能缺少仓库根目录的共享参考清单。把入口、材料和工具配齐之后，才有条件检验流程是否按预期工作。

来源与核验

资料核对

本页按已固定提交核验了安装说明、九条 Claude 命令、所选 Skill 与参考资料。未安装或执行第三方 Skill；示例产物均为文档预期，安装时获得的版本可能更新。

作者说明

按下一步需要继续选择

需求价值与产品取舍还未确定时，可先用 PM Skills 整理证据；若主要问题是已有代码的结构和维护成本，可进一步做严格的代码质量审查。

PM Skills产品管理插件集合，把访谈整理、假设验证、PRD 和路线图变成有步骤的协作流程。Thermo-Nuclear Review给 AI 一条维护性审查标准：追踪新增分支与模糊边界，提出能删掉整层复杂度的改法。Taste Skill让 AI 从品牌材料或业务数据出发，确定设计方向、实现网页，并用浏览器截图检查官网与应用界面。Matt Pocock Skills按需组合的工程技能：问清需求、整理规格、拆分工单、先测后写、排查 Bug 和检查架构。