SuperAPI AI 工具集

initiative

办公与效率

查看项目

更新于 11-04 20:00

技能介绍

用途

initiative 是一个项目管理类技能,用于把一句模糊的产品想法转化为结构化、经过验证的倡议(initiative)工件,作为需求细化与任务创建的前置输入。它保留“问题意图”,而不提前锁定解决方案或技术栈。原命令名为 /idea,现统一使用 $initiative,旧斜杠命令不保留别名。

主要能力

  • 按固定流程采集问题、价值、目标用户与初步范围。
  • 依据 initiative-template.md 生成编号为 INITIATIVE-{YYMMDD}-{NNN} 的草稿,初始状态为 draft。
  • 静默检测项目模块:从配置、规范索引与现有文档中解析模块及其工件归属;仅在存在歧义或无匹配时询问用户;匹配到多个模块时全部加载并列入 related_features。
  • 加载特性上下文,预算为 8-12K tokens,读取模块概览与相关业务规则、测试用例标识等。
  • 将工件保存到团队工件根目录下的 initiatives/ 路径,文件名格式为 initiatives/{YYMMDD}-{role}-initiative-{slug}.md,slug 为小写化、非字母数字替换为连字符、去首尾、最长 50 字符。
  • 执行一轮发现访谈(4-6 个结构化问题,每个类别最多问一次),类别涵盖问题清晰度、用户画像、范围、可测试性、影响/价值、约束、规模、干系人;可测试性问题始终包含。
  • 撰写验证摘要,列出已确认决策与后续行动项,并用一个确认问题核实修订后的问题陈述与范围。
  • 最后建议下一步:$work-item --mode=refine(推荐)、$spec [mode=tests] 或 $plan。

使用方式

以技能调用形式触发,例如:

$initiative "Dark mode toggle for settings"

生成:<team-artifacts 根>/initiatives/260119-po-initiative-dark-mode-toggle.md

$initiative "Add goal progress tracking notification"

生成带模块上下文的工件

流程步骤依次为:收集信息 → 生成工件 → 记录细节 → 检测模块 → 加载上下文 → 保存工件 → 发现访谈 → 验证摘要 → 建议下一步。步骤顺序不可跳过、重排或合并,除非用户明确批准;每个步骤前后需更新任务跟踪状态(in_progress → completed),完成步骤需简要证据,跳过步骤需明确理由。若任务跟踪工具不可用,需维护等效跟踪器并同步状态。

保存路径默认位于 team-artifacts 根下的 initiatives/,若 docs/project-config.json 中配置了 docsRoots.teamArtifacts.path 则以其为准。角色标识从上下文推断或询问用户。

适用场景

  • 已有代码库:需要把新功能想法落成结构化倡议,并关联到既有模块与业务规则。
  • 全新项目(Greenfield):无代码目录、无清单文件、无 project-config.json 时自动进入该模式,跳过模块检测与项目结构读取,聚焦市场空白、竞品与差异化,可启用 WebSearch 获取市场与竞品信息,并更频繁地询问业务问题。
  • 下游任务细化前的准备:为 $work-item --mode=refine 提供干净的问题叙述。

限制与规则

  • 倡议内容必须与技术栈无关:不得命名框架、产品、语言或设计模式;技术栈偏好推迟到后续技术调研阶段。Greenfield 模式下严禁询问技术栈。
  • 倡议不分配逻辑 ID(如 FR-/BR-),这些 ID 由下游任务分配;抽象来源锚点 [Source: namespace/service/id] 应放在独立证据载体中,不得把物理代码坐标或仓库路径写入倡议叙述。
  • 发现访谈与验证确认均为强制步骤,不可省略。验证摘要需从访谈答案派生,并始终附加一个确认问题,无论答案是否改变了原文本。
  • 工件必须包含 t_shirt_size 字段。
  • 该技能只负责捕获与验证,不代表批准;批准与后续状态变更、类型、优先级、截止日期等跟踪字段由 $task-track 记录。
  • 若项目启用了任务跟踪(observe 或 linked 模式),在捕获、开始、保存、验证、交接与关闭检查点需读取链接的工作集成指南。
  • 模块检测时若声明无效或无法解析则保持阻塞状态,不得凭文件名选择配置。
  • 涉及子代理的任务,技能激活即授权使用所需 spawn_agent 子代理;宿主工具名称映射无需批准,但所需能力实际不可用时须停止并记录步骤与证据后向用户提问。
  • 输出格式包含域上下文(模块、相关特性、域实体、既有业务规则)与 UI 草图(布局与关键组件;纯后端倡议标注为不适用)。

暂未提供

该技能的定价、许可证、平台支持范围及独立工具形态在资料中未提供。