القائمة
对新请求执行深度探索、缺陷根因分析或预研；用于 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 没有把需要用户取舍的问题包装成事实结论。