Community研究与数据分析github.com

iamk3nnyt/claude-skills

将功能构思转化为一页规格文档,涵盖问题、受众、MVP 范围、非目标、编号的 Given/When/Then 验收标准、受影响的路径、数据和电子邮件以及未决问题。

claude-skills 是什么?

该技能专为 AI 智能体(如 Claude Code、Cursor、Codex)设计,用于在开发工作流中快速将模糊的功能构思拆解为结构化的单页需求规格说明书(Brief)。当用户发出“brief”、“spec this”、“scope this”或“what would it take”等指令,或者需要澄清一个功能范围时,你可以激活它。它首先会静默读取项目的 CLAUDE.md 和记忆文件,并扫描相关的路由、数据表或邮件模板,以确保规格引用真实的文件路径和字段。该技能的最大价值在于,它内置了一套严格的 MVP 范围控制规则,要求你只使用现有的组件和字段,避免引入未要求的管理后台、分析功能或设置项,并将不需要的功能明确列为非目标。最终,AI 会输出包含问题陈述、目标用户、MVP 要点、验收标准(编号的 Given/When/Then)、影响范围和风险以及每项都带有默认建议的未决问题的完整 Markdown 文档。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iamk3nnyt/claude-skills/tree/HEAD/skills/brief

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

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

文档

brief

特性:$ARGUMENTS

首先进行基础信息收集(静默执行)

  • 阅读此仓库的 CLAUDE.md 和该项目的记忆条目。浏览该功能所涉及的路由、配置和邮件模板。规格文档应引用真实的文件路径和现有字段。
  • 仅当某个决定会改变范围时,才进行询问。使用 AskUserQuestion 一次只问一个问题,并提供推荐选项,最多不超过 3 个问题。其余内容均作为待定问题中的假设列出。

范围制定规则

  • MVP 是指在现有字段和组件基础上构建的常规最小化产品。“像任何电商一样”意味着标准流程,而非平台。
  • 绝不添加未要求的功能、设置、管理页面或分析功能。将它们列在非目标中。
  • 合作伙伴或 API 功能:“API key”通常指环境中的租户 ID,而非开发者门户。
  • 尊重 CLAUDE.md/记忆文件中的项目约束(例如“不允许更改 schema”)。标记任何可能违反约束的内容。

模板

# <特性>: brief
**问题:** 一两句话,描述用户的痛点,而非解决方案。
**目标用户:** 谁,以及如果已知的话有多少人(引用数据来源或查询条件)。
**MVP:** 3–6 个要点,每个都可交付且可观察。
**非目标:** 当前明确不做的事情。
**验收标准**
1. Given <状态>, When <操作>, Then <可观察结果>.
2. ……(每个标准都可通过 flow-check、smoke 测试或单元测试进行验证)
**影响范围:** 路由 · 表/字段(优先使用现有字段) · 邮件 · 环境变量/密钥 · 第三方
**风险:** 资金、法律/GDPR、投递能力、SEO(noindex/canonical)、国际化
**待定问题:** 编号列出的问题;每个问题附带我的默认答案(如果未被回答)

输出

  • 默认在聊天中输出。仅在用户要求时写入 docs/briefs/<slug>.md。
  • 一句开场白(“简要内容如下:N 个验收标准,M 个待定问题”),然后是简要内容。之后不附加任何内容。

退出标准

  • 每条验收标准都是可观察的,并且对应一项检查(flow-check 步骤、smoke 测试期望或测试用例)。
  • MVP 中不包含未被要求或非严格必需的内容。
  • 每条待定问题都有默认答案,以便无需等待即可开始构建。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

iamk3nnyt/claude-skills

Checks UI copy across locales by comparing key parity between next-intl message catalogs and in-code sv/en COPY objects, finding placeholder and array mismatches and words from the other language leaking in (the "och" in English bug), then manually reviewing claims against terms and pricing and the project's banned phrases. Use after editing copy or translations, before shipping a page with new text, or when asked to proofread or check translations.

iamk3nnyt/claude-skills

Applies an agreed visual direction to a page or component by reusing existing components first, then verifies every width and dark mode with the headless-Chrome audit plus a before/after pixel diff, and reviews against Refactoring UI, Nielsen and WCAG 2.2. Use when asked to redesign, restyle, polish or "make it look like the reference", after design-ref or when the direction is already clear.

iamk3nnyt/claude-skills

Extracts the visual system from a reference site or pasted HTML (colour roles, type scale, spacing scale, radii, shadows, button/card/eyebrow anatomy, tone) and maps it onto the current project's existing tokens as a short token table. Use when the user shares a reference ("make it look like <site>", "in this style", a URL or HTML paste) before a redesign.

iamk3nnyt/claude-skills

QAs a project's transactional and digest emails by rendering every template without DB or network, screenshotting at 600 and 375 px in light, dark and images-off, and checking for placeholder leaks (undefined, NaN, {{…}}), preheader, unsubscribe, alt text, absolute links, Outlook-safe buttons, viewport meta and Gmail's 102 KB clip. Use when email templates change, before sending a campaign, or when asked to check how emails look.

相关技能