ML

mouse-lin/finesse-brief

Developer tools
64 stars 품질 55 트렌드 55

给 AI 编码助手用的「工作台架构师」技能。它不写界面 —— 它负责回答*这东西到底是什么*,然后输出一份能直接开工的 ,交给 finesse-ui 或任何会写页面的 AI。

개요

给 AI 编码助手用的「工作台架构师」技能。它不写界面 —— 它负责回答*这东西到底是什么*,然后输出一份能直接开工的 ,交给 finesse-ui 或任何会写页面的 AI。 一个 Skill,只干一件事:把一句模糊的需求(「养宠物」「我想做个 CRM」)整理成一份完整的工作台定义 —— 定位、核心模块、首屏结构、页面层级、数据模型、打开时看到的第一句话,写进 .workbench/spec.md。 产出物永远是**(手机浏览器里的 H5,或电脑浏览器里的 Web 控制台),不是 App。它覆盖两种场景: - —— 一个人一个领域的每日回访页(经期 · 增肌 · 养宠 · 记账 · 摆摊 · 陪孩子学习):说一个词就给完整方案 - —— 围着一个业务对象转的多模块工作台(CRM · ERP · AI Agent 控制台 · 数据看板 · 智慧工厂 · 项目管理 · 电商后台…):问两句再给完整 spec 拿到 spec 后交给 finesse-ui(或 Cursor / v0 / 通义 / 任何会写页面的 AI)就能直接建界面。想了解背后的方法论(怎么找证据、11 种结构怎么分、字段怎么绑、常见死法),看 skills/finesse-brief/references/,一共 9 篇。 装好之后在对话里说「帮我想个工作台」「养宠物」或 /workbench 就会触发。 —— 见下面的安装 & 工具支持。 推荐 npx skills,一条命令通用于所有 agent(运行时会让你选装到哪个工具)。手动装法在下面的折叠区里。 规则挂在 .workbench//spec.md 上,也可以在对话里直接 @ 它。

README

中文 | English


它是什么

一个 Skill,只干一件事:把一句模糊的需求(「养宠物」「我想做个 CRM」)整理成一份完整的工作台定义 —— 定位、核心模块、首屏结构、页面层级、数据模型、打开时看到的第一句话,写进 .workbench/spec.md

产出物永远是网页(手机浏览器里的 H5,或电脑浏览器里的 Web 控制台),不是 App。它覆盖两种场景:

  • 个人域 —— 一个人一个领域的每日回访页(经期 · 增肌 · 养宠 · 记账 · 摆摊 · 陪孩子学习):说一个词就给完整方案
  • 系统域 —— 围着一个业务对象转的多模块工作台(CRM · ERP · AI Agent 控制台 · 数据看板 · 智慧工厂 · 项目管理 · 电商后台…):问两句再给完整 spec

拿到 spec 后交给 finesse-ui(或 Cursor / v0 / 通义 / 任何会写页面的 AI)就能直接建界面。想了解背后的方法论(怎么找证据、11 种结构怎么分、字段怎么绑、常见死法),看 skills/finesse-brief/references/,一共 9 篇。


怎么用

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(运行时会让你选装到哪个工具)。手动装法在下面的折叠区里。

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

MIT · 西瓜同学

View this README on GitHub

추천 도구

다른 키워드를 입력하거나 필터를 제거해 보세요.

설치

npx skillfish add mouse-lin/finesse-brief