SuperAPI AI 工具集

brief

写作与研究

查看项目

更新于 10-16 04:50

技能介绍

brief 是一个对话式项目简报生成技能,主要用于在开始新想法、隔一段时间后重新审视想法、创建规格文档之前,或愿景不清晰时,通过交互式发现流程创建或改进项目简报。

用途 该技能面向项目前期的构想梳理阶段,帮助用户通过对话方式明确问题、方案、受众、功能优先级、差异化和成功指标,并输出结构化项目简报。

主要能力 提供多种使用方式:

  • /brief:为当前或新项目进行交互式发现
  • /brief --project coordinatr:为指定项目生成简报
  • /brief --review:分析现有简报(不编辑)
  • /brief --force:从零开始(需确认)

输出位置为 ideas/[project]/project-brief.md。

执行流程

  1. 判断模式:
  • 不存在简报 -> 完整发现模式
  • 存在简报且无标志 -> 差距驱动的更新模式
  • 带 --review 标志 -> 分析模式(不编辑)
  • 带 --force 标志 -> 确认后重新开始
  1. 调用 brief-strategist 智能体。
  2. 进行六阶段交互式对话(每次一个问题)。

六阶段发现主题

  • 问题发现:是什么问题?谁遇到这个问题?当前有哪些解决方案?
  • 方案探索:你的方案如何运作?核心价值主张是什么?
  • 受众定义:目标用户具体是谁?有哪些特征?
  • 功能优先级:MVP 功能有哪些?哪些可以延后?
  • 差异化:与替代方案相比有什么不同?
  • 成功指标:如何衡量成功?

简报结构 简报包含 frontmatter(status、created、updated)以及以下章节:

  • Executive Summary(执行摘要)
  • Problem Statement(问题陈述)
  • Solution Approach(解决方案)
  • Target Audience(目标受众)
  • Success Criteria(成功标准)
  • Scope and Constraints(范围与约束)
  • Project Phases(项目阶段)
  • Risk Assessment(风险评估)

适用场景

  • 启动一个新想法
  • 隔一段时间后重新审视某个想法
  • 创建规格文档之前
  • 愿景感觉不清晰时

不适用场景:快速笔记(使用 notes/)、技术研究(/research)、功能细节(/spec)。

后续步骤 /brief -> /critique -> /research -> /spec -> /plan