SuperAPI AI 工具集

fp-brief

通用与其它

查看项目

更新于 10-16 09:52

技能介绍

用途:fp-brief 是一个 First-Principles Briefing Skill,用于从技术文档中提炼第一性原理简报。适用场景包括:理解决策为何做出、为功能推理逻辑做上手、复盘决策,以及假设分析。不适用场景:面向 PM/CTO 的高管摘要、写规格前的可行性分析、函数/文件级代码解释、代码架构概览、简单文档摘要。

主要能力:按需输出多段分析,包括 Root Problem(根问题,5-Why)、Assumptions Register(假设登记,含置信度)、Reasoning Chain(推理链,逐条引用来源章节)、Alternative Rejection Log(替代方案否决记录)、Decision Sensitivity(假设失效时哪些决策会崩塌)、Open Unknowns(未知项)。可选 --verify codex 调用 Codex 做独立推理验证,追加 Verification Delta(第 7 节)。深度分 brief、normal、deep 三档,分别约 500、1500、2500 词上限,条目为上限而非目标,资料不足时输出“Evidence insufficient”标记而不编造内容。

使用方式:命令签名为 /fp-brief <doc-path> [--depth brief|normal|deep] [--verify off|codex] [--output <path>] [--no-save]。<doc-path> 必填,为源 markdown 文档路径;--depth 默认 normal;--verify 默认 off;--no-save 时仅打印到 stdout 而不写文件。流程分为输入解析(路径校验、边界限制、敏感信息脱敏、格式自动识别)、第一性原理提取(六个分析部分)、输出组装(深度过滤、来源引用、写文件)。长文档(超过 500 行)按 ## 标题拆分后逐段提取再合并去重。输出默认与源文件同目录,文件名加 -fp-brief.md 后缀,例如 docs/features/auth/2-tech-spec.md → docs/features/auth/2-tech-spec-fp-brief.md;--output 可自定义路径。

限制:--no-save 与 --verify codex 不兼容,会被拒绝,因为验证提示依赖磁盘上的输出文件。长度受深度档上限约束,源文档内容不足时相应段落会更短或标注证据不足。格式自动检测依赖 references/detection-rules.md。其余平台支持、收费方式、性能指标等资料暂未提供。