Use Case Writer
phucnt-bazone-vietnam/use-case-writer
Generate Use Case specifications in English Markdown following the IT BA standard 13-field template (Karl Wiegers / IIBA).
输入一个产品 idea(一句话或详细描述均可),自动生成图文并茂、结构完整的 BRD(商业需求文档),以 Markdown 格式保存到当前项目 markdown/ 目录,同时输出配套 SVG 图表文件。触发条件:用户提到"写 BRD"、"帮我写需求文档"、"生成 BRD"、"写商业需求文档"、"我有个产品想法"、"帮我把这个 idea 写成文档"、"PRD/BRD…
$ npx skills add digoal/blog --skill write-brd -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install digoal/blog write-brd --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skills_for_claude_web/write-brd .claude/skills/write-brd && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/write-brd into .claude/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/write-brdType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add digoal/blog --skill write-brd -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install digoal/blog write-brd --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/skills_for_claude_web/write-brd .agents/skills/write-brd && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/write-brd into .agents/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add digoal/blog --skill write-brd -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install digoal/blog write-brd --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/skills_for_claude_web/write-brd .cursor/skills/write-brd && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/write-brd into .cursor/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/digoal/blog.git --path skills/skills_for_claude_web/write-brd--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add digoal/blog --skill write-brd -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install digoal/blog write-brd --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/skills_for_claude_web/write-brd .gemini/skills/write-brd && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/write-brd into .gemini/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install digoal/blog write-brdInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add digoal/blog --skill write-brd -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/skills_for_claude_web/write-brd .github/skills/write-brd && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/write-brd into .github/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add digoal/blog --skill write-brd -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install digoal/blog write-brd --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/digoal/blog.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/skills_for_claude_web/write-brd .opencode/skills/write-brd && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "write-brd" agent skill from https://github.com/digoal/blog/tree/master/skills/skills_for_claude_web/write-brd into .opencode/skills/write-brd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-brd", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
write-brd输入一个产品 idea(一句话或详细描述均可),自动生成图文并茂、结构完整的 BRD(商业需求文档),以 Markdown 格式保存到当前项目 markdown/ 目录,同时输出配套 SVG 图表文件。触发条件:用户提到"写 BRD"、"帮我写需求文档"、"生成 BRD"、"写商业需求文档"、"我有个产品想法"、"帮我把这个 idea 写成文档"、"PRD/BRD…
Write Brd is an agent skill from digoal/blog. 输入一个产品 idea(一句话或详细描述均可),自动生成图文并茂、结构完整的 BRD(商业需求文档),以 Markdown 格式保存到当前项目 markdown/ 目录,同时输出配套 SVG 图表文件。触发条件:用户提到"写 BRD"、"帮我写需求文档"、"生成 BRD"、"写商业需求文档"、"我有个产品想法"、"帮我把这个 idea 写成文档"、"PRD/BRD 模板"、"产品立项文档"。即使用户只给出一句简短的产品描述如"我想做一个 XX 产品",也应立即使用本 skill 生成 BRD。本 skill 面向产品经理、创业者、产品负责人,输出可直接用于团队评审和立项决策的专业文档。
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Product & Project Management, covering PRD writing and Markdown. The repository describes itself as: AI,Opensource,Database,Business,Finance,Minds. git clone --depth 1 https://github.com/digoal/blog. The licence is GPL-2.0.
4 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 69fb793. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Write Brd loads about 1.5k tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 181 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from digoal/blog at commit 69fb793, republished under its GPL-2.0 licence (© digoal). 181 words, ~1,499 tokens.
.claude/skills/write-brd/SKILL.md (or your agent's skills folder).将一个产品 idea 转化为完整、可直接评审的 BRD(Business Requirements Document)。
用户输入 Idea
↓
Step 1: 信息补全与假设推演
↓
Step 2: 搜索市场背景与竞品(web search)
↓
Step 3: 生成配套 SVG 图表(独立文件)
↓
Step 4: 生成完整 BRD Markdown 文件
↓
输出到 markdown/ 目录拿到用户的 idea 后,不要立刻问问题,而是先做推演:
如果用户提供的信息足够(或者可以合理推断),直接进入 Step 2,不要打断流程问问题。
推断优先于询问,在 BRD 中标注"[待确认]"的字段,告知用户哪些是推断。
搜索以下信息,用于充实 BRD 背景章节:
搜索关键词格式:[产品领域] market size, [产品类型] competitors, [用户痛点] trends 2024
必须生成以下至少 2 个 SVG 图表,保存到 markdown/ 目录:
[product-name]-architecture.svg[product-name]-user-journey.svgSVG 技术规范:
viewBox="0 0 820 [适当高度]"
font-family="'PingFang SC', 'Helvetica Neue', Arial, sans-serif"
使用渐变色增强视觉层次
添加 filter shadow 增强立体感
配色参考:
主色调:#667eea(科技蓝紫)
成功色:#43a047(绿)
警告色:#e65100(橙)
危险色:#c62828(红)
背景:#f7f8fc 或 white文件命名:[product-name-en]-brd.md(英文小写,连字符分隔)
# [产品名称] BRD
> [一句话摘要:这个产品为谁解决了什么问题,通过什么方式]
**文档状态**:草稿 / 评审中 / 已批准
**版本**:v1.0
**作者**:[PM 姓名]
**最后更新**:[日期]
**阅读时长**:约 X 分钟
---
## 一、执行摘要(Executive Summary)
[3-5句话的高管版摘要,包含:问题规模、解决方案、预期商业价值]
---
## 二、问题定义
### 2.1 背景与现状
[市场背景,数据支撑,不超过200字]
### 2.2 用户痛点(JTBD 框架)
当 [目标用户] 在 [使用场景] 时,
他们需要 [完成某个任务/达到某个目标],
但目前面临 [具体障碍],
导致 [业务/用户体验影响]。
### 2.3 目标用户
**主要用户群体**:[描述]
**用户画像**:
- 人口属性:[年龄/职业/地域]
- 使用场景:[什么时候、在哪里、为什么]
- 当前行为:[他们现在怎么解决这个问题]
- 痛点优先级:[最痛的3个点]
### 2.4 市场机会
| 指标 | 数值 | 来源 |
|------|------|------|
| TAM(总市场规模) | | |
| SAM(可服务市场) | | |
| SOM(可获取份额) | | |
---
## 三、解决方案
### 3.1 产品定位
[一句话定位:我们是[产品类型],帮助[目标用户],[核心价值主张],不像[竞品],我们[差异化]。]
### 3.2 功能架构

### 3.3 核心功能(MoSCoW 优先级)
#### Must Have(MVP 必须包含)
| 功能 | 用户故事 | 验收标准 | 优先级 |
|------|---------|---------|--------|
| [功能1] | As a [用户], I want [行为], so that [目的] | Given [场景] When [动作] Then [结果] | P0 |
#### Should Have(重要但可简化)
[同上格式]
#### Could Have(有余力再做)
[列表形式即可]
#### Won't Have(本期明确不做)
[列表,说明原因]
### 3.4 用户旅程

### 3.5 非功能需求
| 维度 | 要求 | 验证方式 |
|------|------|---------|
| 性能 | [具体指标,如页面加载<2s] | 压测 |
| 安全 | [如符合 SOC2 / GDPR] | 安全审计 |
| 可用性 | [如支持 99.9% uptime] | 监控告警 |
| 扩展性 | [如支持 X 并发用户] | 架构评审 |
---
## 四、竞品分析
[竞品对比矩阵或文字分析,说明差异化优势]
---
## 五、成功指标
### 5.1 北极星指标(North Star Metric)
[唯一最重要的指标,及其计算方式]
### 5.2 关键指标体系
| 指标 | 基线 | 目标值 | 观测周期 |
|------|------|--------|---------|
| [核心业务指标] | [当前值] | [目标值] | [周/月] |
| [用户行为指标] | | | |
| [技术质量指标] | | | |
### 5.3 实验设计
- A/B 测试方案:[描述]
- 灰度策略:[5% → 20% → 100%]
- 回滚条件:[出现什么情况触发回滚]
---
## 六、执行计划
### 6.1 范围边界
**In Scope(本期包含)**:
- [功能列表]
**Out of Scope(本期不做)**:
- [明确排除的功能,及原因]
### 6.2 里程碑
| 阶段 | 内容 | 时间节点 | 负责人 |
|------|------|---------|--------|
| Discovery 完成 | 用研报告、竞品分析 | [日期] | PM |
| 设计评审 | 高保真原型通过 | [日期] | Design |
| 技术评审 | 架构方案确认 | [日期] | Tech |
| MVP 上线 | 核心功能可用 | [日期] | 全团队 |
| 数据验证 | 关键指标达标 | [日期] | PM |
### 6.3 资源需求
| 角色 | 工作量(人天) | 备注 |
|------|-------------|------|
| 产品经理 | | |
| 设计师 | | |
| 前端工程师 | | |
| 后端工程师 | | |
| 测试工程师 | | |
---
## 七、风险评估
| 风险 | 可能性 | 影响 | 应对方案 |
|------|--------|------|---------|
| [技术风险] | 中 | 高 | [具体措施] |
| [市场风险] | 低 | 高 | [具体措施] |
| [资源风险] | 中 | 中 | [具体措施] |
| [合规风险] | 低 | 极高 | [具体措施] |
---
## 八、干系人与审批
### 8.1 RACI 矩阵
| 事项 | PM | 工程 | 设计 | 运营 | 法务 | 高层 |
|------|----|----|------|------|------|------|
| 需求确认 | R | C | C | I | I | A |
| 技术方案 | C | R | I | | | I |
| 上线决策 | R | C | C | C | C | A |
*R=负责执行 A=最终决策 C=需咨询 I=需知会*
### 8.2 审批记录
| 干系人 | 角色 | 意见 | 签字日期 |
|--------|------|------|---------|
| | | | |
---
## 九、附录
### 9.1 术语表
[项目专有名词解释]
### 9.2 参考文档
- [用研报告链接]
- [竞品分析报告]
- [技术可行性评估]
- [相关数据分析]
### 9.3 修订历史
| 版本 | 日期 | 修改内容 | 修改人 |
|------|------|---------|--------|
| v1.0 | [日期] | 初始版本 | |
---
*本文档由 write-brd skill 生成 · 请在评审完成后删除此行*生成完成后,markdown/ 目录应包含:
markdown/
├── [product-name]-brd.md ← 主文档
├── [product-name]-architecture.svg ← 功能架构图
├── [product-name]-user-journey.svg ← 用户旅程图
└── [product-name]-*.svg ← 其他可选图表直接推演,用 [待确认] 标注假设字段,生成完整文档后告知用户哪些需要补充。
提取关键信息后按模板生成,无需额外搜索即可完成大部分内容。
只生成核心章节:问题定义 + Must Have 功能 + 成功指标 + 里程碑,省略其余章节。
在竞品分析部分增加"购买决策链分析",成功指标加入客户成功指标(NPS / Churn Rate)。
简化市场分析部分,增加"效率提升量化"章节,指标侧重内部 ROI。
以下均应触发本 Skill:
© digoal, GPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in skills/skills_for_claude_web/write-brd of digoal/blog.
Open the folder on GitHubat commit 69fb793
Write Brd next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Write Brd this skilldigoal/blog | 8.6k | — | ~1.5k | Automated safety check: Pass | GPL-2.0 | |
| Use Case Writerphucnt-bazone-vietnam/use-case-writer | 142 | — | ~4.1k | Automated safety check: Pass | MIT | |
| CCPM Project Managementautomazeio/ccpm | 8.4k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Ralph Tui Create Beadssubsy/ralph-tui | 2.5k | 1 repos | ~2.6k | Automated safety check: Pass | MIT | |
| Trellis Brainstormanjiemo/SunnyBeach | 178 | 7 repos | ~4k | Automated safety check: Pass | Apache-2.0 | |
| Adversarial Speczscole/adversarial-spec | 556 | 1 repos | ~8.3k | Automated safety check: Notes | MIT |
phucnt-bazone-vietnam/use-case-writer
Generate Use Case specifications in English Markdown following the IT BA standard 13-field template (Karl Wiegers / IIBA).
automazeio/ccpm
Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.
subsy/ralph-tui
Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.
anjiemo/SunnyBeach
Guides collaborative requirements discovery before implementation.
zscole/adversarial-spec
Iteratively refine a product spec by debating with multiple LLMs (GPT, Gemini, Grok, etc.) until all models agree.
subsy/ralph-tui
Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).
digoal/blog
三层审查模型,逐段逐句验证文章真伪、证据链与逻辑结构。Use when the user asks to fact-check, verify, audit, or evaluate the credibility of an article, essay, report, opinion piece, social-media post, or any written claim —…
digoal/blog
Find latent bugs in a local PostgreSQL source tree (RELxxSTABLE branch or HEAD) the way a core hacker does: build a heavily-poisoned debug instance (cassert + cache-discard + -O0/-ggdb3 + core…
digoal/blog
Portable digital employee distilled from digoal's personal blog for PostgreSQL, PolarDB, DuckDB, AI+database, vector/RAG, database operations, source-code reading, technical content creation…
digoal/blog
从论文 PDF 文件或论文 PDF URL 生成通俗易懂、图文并茂、带批判性评估的中文 Markdown 解读,并保存到当前项目的 markdown 目录。Use when the user asks to interpret,精读,解读,summarize,explain,analyze, or write an article from an academic paper PDF…
digoal/blog
Analyze a product from documentation, websites, PDFs, articles, release notes, pricing pages, app listings, reviews, filings, or related links; save separate intermediate analyses from seven roles…
digoal/blog
Turn a blog post, article, notes, or any source material into a set of vertical poster images — one cover plus several coherent content slides that explain the core points.
Categories
输入一个产品 idea(一句话或详细描述均可),自动生成图文并茂、结构完整的 BRD(商业需求文档),以 Markdown 格式保存到当前项目 markdown/ 目录,同时输出配套 SVG 图表文件。触发条件:用户提到"写 BRD"、"帮我写需求文档"、"生成 BRD"、"写商业需求文档"、"我有个产品想法"、"帮我把这个 idea 写成文档"、"PRD/BRD…. Write Brd is an agent skill from digoal/blog.
Write Brd fits situations like: tasks that involve PRD writing; tasks that involve Markdown.
Run `npx skills add digoal/blog --skill write-brd -a claude-code`. Or copy the skill folder (skills/skills_for_claude_web/write-brd in digoal/blog) into .claude/skills/write-brd in your project. Claude Code loads it when a task matches its description.
Run `npx skills add digoal/blog --skill write-brd -a codex`. Or copy the skill folder (skills/skills_for_claude_web/write-brd in digoal/blog) into .agents/skills/write-brd in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add digoal/blog --skill write-brd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/write-brd, .gemini/skills/write-brd, .github/skills/write-brd and .opencode/skills/write-brd in your project.
SKILL.md names no scripts, command-line tools or credentials: Write Brd is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Write Brd is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Write Brd: Use Case Writer (phucnt-bazone-vietnam/use-case-writer, 142 stars), CCPM Project Management (automazeio/ccpm, 8.4k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars) and Trellis Brainstorm (anjiemo/SunnyBeach, 178 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
digoal (a GitHub user) maintains it in digoal/blog, which has 8,587 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on September 28, 2026.
Source: digoal/blog on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.