SuperAPI AI 工具集

idea-finder

通用与其它

查看项目

更新于 10-16 10:22

技能介绍

用途:idea-finder 是独立的命令行工具,用于编排以证据为本的需求调研。当用户要求兼容的智能体(如 Codex)发现或聚焦某调研主题时,由智能体把自然语言请求转成对 idea-finder CLI 的调用,而非自行实现业务逻辑。具体安装方式、精确命令与响应字段见 references/cli-workflows.md。\n\n主要能力:提供工作区诊断、方案提议与确认、研究运行与检查、证据导出、机会与拒收视图、校准与验证、监控调度等子命令。所有命令应使用 --json 输出并解析带版本的 envelope,不要抓取人类可读输出。需复用返回的 Brief、ResearchRun、claim、Opportunity、experiment、proposal、comparison 等 ID,不得自行编造。\n\n使用方式:每条命令都显式传 --workspace <绝对路径>,不依赖进程 cwd;CLI 默认工作区为 macOS 的 ~/Library/Application Support/idea-finder/workspace,其他平台为 ~/.local/share/idea-finder/workspace,可用 IDEA_FINDER_WORKSPACE 覆盖。变更工作区前先运行 idea-finder workspace diagnostics --workspace <dir> --json;诊断不创建目录,需要创建时用 --init。新主题先 idea-finder plan propose --topic "<topic>" --workspace <dir> --json,展示主题、画像、场景、语言、地域、时间窗、来源族、研究视角与预算,等待用户明确确认后再执行 idea-finder plan confirm <planId> [--mode explicit|start_now] [--slug <slug>] --workspace <dir> --json,随后 research run / research inspect / export。用户说“直接开始”时按 --mode start_now 处理,并先用 plan confirm 记录默认参数。\n\n来源选择:定性需求、痛点、变通方案、商业意图与矛盾证据使用 HN、V2EX、App Store 评论、Stack Exchange 或用户显式导入;Google Trends 仅用于搜索动量(需 IDEA_FINDER_GOOGLE_TRENDS_ENDPOINT,缺失时 fail-closed authorization_required);GitHub 指标仅用于开发者采用与供需/竞争,优先 GITHUB_TOKEN / GH_TOKEN 或已认证 gh;npm 或 PyPI 下载量仅用于包采用,并保留 PyPI 第三方数据警示。登录受限来源需显式授权,否则请用户提供导入,不得绕过登录、访问控制、robots 政策或来源条款。\n\n限制:默认实时调研,仅演示与确定性测试才可用 --fixture / --fixture-set;不得编造或粘贴 fixture 数据填补失败、限流、未授权或零结果来源的空缺。--manual-import 仅用于本轮用户显式提供的文本、用户指定文件或用户明确授权导入的既有材料,须逐字导入,不得增补痛点、变通、付费意愿、画像、频率或来源细节。同一轮多次手动导入仍属单一人工来源通道,不能算跨来源互证。趋势、排名、星标、fork 或下载量本身不等于已验证需求。退出码 6 与 envelope 的 partial 表示保留但不完整,不是完全失败。校准与验证属人工决策,须先检查 Opportunity 并展示证据与不确定性,再让用户明确决定是否调用 board calibrate、validation add、validation complete;监控用 monitor schedule 设置人工/每日/每周节奏,由 Codex Automation、cron 等外部调度器触发 monitor run,不内置计时器。结论在覆盖或证据不完整时应保持条件化表述。