메뉴
对新请求执行深度探索、缺陷根因分析或预研；用于 brief 不足以支撑后续 artifact，或 ready artifact 为 gap_report / research 时。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
SpecForge requirements 主能力包。用于把 brief、brainstorm、PRD、research、gap report、wiki 当前事实和用户确认转成可测试、可追踪、可交给 UI / technical design / tasking / verification 的 REQ / AC / NFR / 边界 / handoff 行为契约。
生成或更新 SpecForge 工作项的需求规格；用于活跃工作项的 ready artifact 为 requirements，或需要把产品需求文档 / 简报转成可测试行为、边界、用户故事、验收标准和影响面标记时。
SpecForge 内部需求技能。用于为 work item 生成清晰、可测试的功能需求、非功能需求、范围边界、不在范围内和验收标准。
SpecForge 跨阶段代码智能能力包。用于任何阶段需要 Wiki-first 定位现有代码范围、选择 CodeGraph / MCP / SCIP / Repomix / rg、检查 provider freshness、归一 graph_facts、分析影响面 / affected tests 或生成 Wiki 回写候选时必读；不要只在 sf-steering 中使用。
为存量项目或大型代码库建立 SpecForge 项目画像；用于新需求或 bugfix 前理解现有架构、刷新 wiki、生成后续 work item 的上下文基线。
SpecForge 测试工程主能力包。用于 sf-verify 在验证前把 requirements、tasks、UI、technical design 和 code review 风险转成可解析 TC/PW 用例、runtime runbook、auth strategy、自动化计划和可归档 evidence。
| name | sf-discovery |
| description | 对新请求执行深度探索、缺陷根因分析或预研；用于 brief 不足以支撑后续 artifact，或 ready artifact 为 gap_report / research 时。 |
执行任何 node .specforge/... 命令或读取 .specforge/... 文件前，必须先定位宿主项目根：项目根是“包含 .specforge/ 目录的业务项目目录”，不是 .specforge/ 目录本身。若当前目录是 .specforge/ 或其任意子目录，先 cd .. 回到宿主项目根；若当前目录是 frontend/、backend/ 等子目录，也先向上回到包含 .specforge/ 的项目根。禁止从 .specforge/ 内执行 node .specforge/core/scripts/...，否则会形成 .specforge/.specforge/... 的错误路径。
把原始诉求升级为有分析证据支撑的 brief，或生成 bugfix 的 gap_report、discovery workflow 的 research。如果分析发现缺的是用户取舍而不是事实证据，暂停并向用户提问。它不写业务实现代码。
.specforge/AGENTS.md。.specforge/registry.yaml，确认当前 active work item。00-intake/original-request.md 和已有 brief.md（如存在）。node .specforge/core/scripts/doctor.mjs。node .specforge/core/scripts/instructions.mjs 判断当前 ready artifact。research，或本次 discovery 引入外部来源、版本事实、政策 / 竞品 / 安全 / SDK 资料，完成前运行 node .specforge/core/scripts/source-quality.mjs。开始 discovery 前，读取 .specforge/skills/sf-discovery/stages/discovery/SKILL.md。brief 的必含内容、停止条件和完成标准以内置母本为准。
.specforge/core/standards/workflow.md：上下文加载、scope、非目标和写入边界。.specforge/core/standards/product.md：分析深度、代码探索、外部研究、候选功能、用户选择和澄清。.specforge/core/skills/ORCHESTRATION.md：第三方研究参考的选择、来源核验和归一化要求。需要外部事实、版本、价格、法规、漏洞、竞品或 SDK / provider 资料时，按需读取 .specforge/core/skills/brainstorm/references/research-source.md。
research-source 只提供本地事实读取、来源选择、证据契约、版本关系、冲突处理和覆盖度检查；复杂 PoC / 实验仍由 discovery research 执行。01-spec/research.md 或 00-intake/brief.md，并保留来源、日期、置信度、覆盖度和未解决问题。.specforge/core/standards/product.md 判断分析深度：light、standard 或 deep。最小可行版本 / 可选增强 / 后续版本 分组并给出推荐组合，再向用户澄清并记录答案。gap_report，运行 node .specforge/core/scripts/create-artifact.mjs gap_report，并写清复现、当前行为、期望行为、根因、修复策略和回归测试。research，运行 node .specforge/core/scripts/create-artifact.mjs research，并写清研究问题、来源、实验、发现、决策和未解决问题。00-intake/brief.md。node .specforge/core/scripts/instructions.mjs；若存在 research 或外部来源，再运行 node .specforge/core/scripts/source-quality.mjs 并修复 FAIL，WARN 需补强来源或记录 owner、影响和接受理由。sf-brainstorm。standard / deep 缺少代码库探索证据或明确跳过原因。deep 缺少外部研究证据或明确跳过原因。brief.md / gap-report.md / research.md 包含足以支撑下一步的分析证据。source-quality.mjs 无 FAIL；WARN 已补强或在 artifact 中写明接受理由。instructions.mjs 已确认下一步 route，且 discovery 没有把需要用户取舍的问题包装成事实结论。