SuperAPI AI 工具集

project-brief

通用与其它

查看项目

更新于 10-16 09:52

技能介绍

用途:把技术规格(tech spec)转换为面向产品经理/CTO 的高层执行摘要,简化技术细节、突出业务价值。

触发方式:关键词 executive summary、project brief、PM summary、CTO summary、project-brief。不适用场景:第一性原理简报(用 /fp-brief)、技术规格撰写(用 /tech-spec)、文档评审(用 /codex-review-doc)。

主要能力:按转换规则处理各部分——可信边界图简化为三层架构;代码分析、可复用模块、关键设计决策删除;系统架构保留但简化;实施路线图、方案对比、风险与缓解、时间线保留;即时行动简化为决策点。

执行流程:读取指定技术规格文件并识别核心价值主张;提取项目概述(一句话说明做什么、为什么、价值)、现状与目标对比、方案评估(保留优缺点对比)、里程碑时间线、风险摘要、资源需求;去除代码片段、内部模块名和技术实现细节,保留业务逻辑描述;产出执行摘要,包含项目概述、现状与目标、方案评估、架构概览(最多三层)、里程碑、风险摘要、资源需求和待决策点。

使用方式:通过 Agent 调度,subagent_type 为 brief-writer,输入以 $ARGUMENTS 传入。默认保存到原文件同目录,加 -brief 后缀,例如 docs/features/xxx/architecture.md 保存为 docs/features/xxx/architecture-brief.md;若 $ARGUMENTS 含 --output <path> 则保存到指定位置。

限制:仅适用于将已有技术规格转为执行摘要,不用于替代技术规格撰写或文档评审;其他能力与运行环境要求暂未提供。