mouse-lin/finesse-brief

Latest recorded source activity: August 3, 2026 at 13:27

SkillsMP catalog refreshed: November 9, 2026 at 14:22

skills collected: 1

GitHub stars: 125
GitHub forks: 15

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/mouse-lin/finesse-brief.

Repository README

Repository README source: README.md

Read the source README

Expand full README

[中文](README.md) | [English](README.en.md) ![finesse-brief](assets/banner.png) <div align="center"> **先想清楚做什么，再想怎么做好看** 给 AI 编码助手用的「工作台架构师」技能。它不写界面 —— 它负责回答*这东西到底是什么*，然后输出一份能直接开工的 **Workbench Spec**，交给 [finesse-ui](https://github.com/mouse-lin/finesse-skill) 或任何会写页面的 AI。 [![version](https://img.shields.io/badge/version-0.5.0-111?style=flat-square)](https://github.com/mouse-lin/finesse-brief/releases) [![license](https://img.shields.io/badge/license-MIT-111?style=flat-square)](LICENSE) [![references](https://img.shields.io/badge/方法文件-9_篇-c9863f?style=flat-square)](skills/finesse-brief/references) [![structures](https://img.shields.io/badge/结构分类-11_种-5ee9c8?style=flat-square)](skills/finesse-brief/references/workbench-types.md) </div> --- ## 它是什么一个 Skill，只干一件事：把一句模糊的需求（「养宠物」「我想做个 CRM」）整理成一份完整的工作台定义 —— 定位、核心模块、首屏结构、页面层级、数据模型、打开时看到的第一句话，写进 `.workbench/spec.md`。产出物永远是**网页**（手机浏览器里的 H5，或电脑浏览器里的 Web 控制台），不是 App。它覆盖两种场景： - **个人域** —— 一个人一个领域的每日回访页（经期 · 增肌 · 养宠 · 记账 · 摆摊 · 陪孩子学习）：说一个词就给完整方案 - **系统域** —— 围着一个业务对象转的多模块工作台（CRM · ERP · AI Agent 控制台 · 数据看板 · 智慧工厂 · 项目管理 · 电商后台…）：问两句再给完整 spec 拿到 spec 后交给 finesse-ui（或 Cursor / v0 / 通义 / 任何会写页面的 AI）就能直接建界面。想了解背后的方法论（怎么找证据、11 种结构怎么分、字段怎么绑、常见死法），看 [`skills/finesse-brief/references/`](skills/finesse-brief/references)，一共 9 篇。 --- ## 怎么用 ```bash npx skills add https://github.com/mouse-lin/finesse-brief ``` 装好之后在对话里说「帮我想个工作台」「养宠物」或 `/workbench` 就会触发。**不用 Claude Code 也能装** —— 见下面的[安装 & 工具支持](#安装--工具支持)。 | 你说 | 会发生什么 | |---|---| | 「养宠物」这类两个字的领域词 | 直接给一版完整方案让你否决，不先反过来问你三个问题 | | 「先给我看看效果 / 直接做出来我看看」 | 走 `sketch`：骨架 → spec → 直接交给 finesse-ui 建界面 | | 「我想做个工作台」（没说管什么） | 只问一句：这个台子主要管什么 | | 「我想做个 CRM / Agent 控制台 / 工厂看板」 | 问两句（围着什么转 · 谁在用 · 每天最常做什么），再一次给完整 spec | | 完全说不上来 | 走证据法：问你已经在用备忘录/Excel 凑合的那件事，或用了十天就删掉的那个 App | ### 命令 | 命令 | 做什么 | |---|---| | `sketch [两个字]` | 快车道 —— 骨架 → spec → 直接建界面，标注为起点 | | `discover` | 从零开始，连方向都没有的时候 | | `define [领域]` | 领域已定且有具体背景，直接定义 | | `hook` | 只改打开时那句话 —— 最常见的单点修复 | | `modules` · `channels` | 只重切模块/频道 | | `data` | **系统域** —— 补或修数据模型（字段、谁写、关系） | | `pages` | **系统域** —— 把模块展开成 L1/L2/L3 | | `monetize` | 找变现口 | | `audit` | 只读体检：结构 / 数据底座 / 对应域的黑名单 | | `narrow` · `widen` | 砍到骨架 / 加深度（不是加功能） | | `handoff` | 写 spec，交给 finesse-ui | --- ## 安装 & 工具支持 > [!NOTE] > 推荐 `npx skills`，一条命令通用于所有 agent（运行时会让你选装到哪个工具）。手动装法在下面的折叠区里。 ```bash npx skills add https://github.com/mouse-lin/finesse-brief ``` | 工具 | 深度 | 装法 | |:---|:---|:---| | **Claude Code** | 完整 | `npx skills` 或原生插件 `.claude-plugin/plugin.json` | | **Trae / Trae 国内版** | 完整镜像 | 复制整个 `.trae/skills/finesse-brief/` 目录 | | **CodeBuddy** | 完整镜像 | 复制整个 `.codebuddy/skills/finesse-brief/` 目录 | | **Cursor** | 单文件规则 | 复制 `.cursor/rules/finesse-brief.mdc` | | **OpenAI Codex** | 单文件指令 | 复制 `AGENTS.md` 到项目根目录 | | **GitHub Copilot** | 单文件指令 | 复制 `.github/copilot-instructions.md` | | **其他（ChatGPT / API）** | 手动 | 把 `SKILL.md` 粘进 system prompt | <details> <summary><b>各工具的具体命令</b></summary> <br> ### Cursor ```bash cp .cursor/rules/finesse-brief.mdc your-project/.cursor/rules/ ``` 规则挂在 `.workbench/**` 和 `**/spec.md` 上，也可以在对话里直接 @ 它。 ### OpenAI Codex ```bash cp AGENTS.md your-project/AGENTS.md ``` Codex 及一票遵循 `AGENTS.md` 约定的 agent 会自动读取。已经有 `AGENTS.md` 的项目，把内容追加进去即可。 ### GitHub Copilot ```bash cp .github/copilot-instructions.md your-project/.github/ ``` ### Trae ```bash cp -r .trae/skills/finesse-brief your-project/.trae/skills/ # 国内版： cp -r .trae-cn/skills/finesse-brief your-project/.trae-cn/skills/ ``` ### CodeBuddy ```bash cp -r .codebuddy/skills/finesse-brief your-project/.codebuddy/skills/ ``` > **为什么这三个是「完整镜像」**：Trae / CodeBuddy 的 Skills 目录结构与 Claude Code 原生一致，能按需加载全部 reference 文件，所以直接复制整个目录就拿到完整深度，不是精简版。 > > **单文件版本（Cursor / Codex / Copilot）是浓缩本**：方法完整、门禁完整，但九篇 reference 的细节在里面是概要。需要深度时，把 `skills/finesse-brief/references/` 一起复制过去，让它按需读。 </details> --- MIT · 西瓜同学

Loading the repository README…

Skills in this repository

classification pending

skill

occupation

description

updated

finesse-brief

unclassified

Define the workbench before anyone builds it — the Workbench Architect that turns one vague sentence into a build-ready Workbench Spec. Runs BEFORE any interface exists and never writes one: it decides WHAT the thing is, and hands finesse-ui (or Cursor, v0,…

2026-08-03

Showing 1 of 1 collected skill.