SpecForge

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。

SpecForge 本地代码审查主能力包。用于 sf-code-review 执行 code_review gate 前，对照 approved spec、tasks、implementation report、changed-files、真实 git diff 和验证证据审查实现是否可批准；每次使用前读取本入口，并按风险读取 references。

执行 SpecForge code_review gate；用于 implementation 完成后，对照 approved spec、tasks、implementation report、changed files 和真实 diff 审查实现是否满足规格、工程规则、安全边界和验证要求。

SpecForge 内部代码审查技能。用于 implementation 完成后，对照 approved spec、tasks、implementation report、changed files、真实 diff 和验证证据判断 code_review gate。

SpecForge 产品发现能力包。用于把模糊产品想法、用户反馈、业务问题、候选功能和数据事实整理成 opportunity map、feature pool、MVP recommendation、experiment plan 和 PRD handoff；每次使用前读取本入口，并按需读取 references。

对模糊产品想法、界面、AI、技术方向或范围取舍做用户参与式头脑风暴；用于进入产品需求文档、需求规格或技术设计前，先查询优秀案例和当前事实，发散多种机制路线，和用户多轮探讨后形成可确认的候选方案、研究证据和决策记录。

生成或更新产品需求文档；用于产品型工作项、AI 功能、后台工具、全栈应用或高层模糊需求在需求阶段前明确核心问题、目标用户、功能候选、最小可行版本边界、成功指标、风险和路线图时。

SpecForge 产品需求文档决策能力包。用于把简报、头脑风暴、产品发现、预研、知识库事实和用户确认转成 00-intake/prd.md；每次 sf-prd 写产品需求文档前都应读取，并按 profile 读取 references。

SpecForge Brainstorm 能力包根入口。用于模糊产品、UI、AI、技术、管理端、网站、工作流或范围取舍需要系统化发散、优秀案例侦察、事实查证、多轮讨论、方案矩阵和下游交接时。使用本能力包时必须先读此入口，再按 profile 读取 references 和 data。

SpecForge 内部 brainstorm 阶段技能。用于在 intake、产品需求文档、需求规格、界面设计或技术设计前后，对模糊方向做用户参与式发散、优秀案例侦察、事实研究、多轮探讨、取舍和确认。

对新请求执行深度探索、缺陷根因分析或预研；用于 brief 不足以支撑后续 artifact，或 ready artifact 为 gap_report / research 时。

SpecForge 内部预研技能。执行架构论证、API可行性测试或技术栈 Spike。

将新仓库或已有仓库接入 SpecForge；初始化唯一项目目录 .specforge/，补齐 core、wiki、hooks、registry 与 work 工作区，并判断下一步是否应进入 sf-steering。

SpecForge UI 设计规范 skill；用于可见体验、设计语言、Design Contract、组件契约、token、动效、视觉 QA 和跨阶段交接。凡涉及新页面、页面重构、后台 / 品牌页 / Web3 / AI / 大屏 / 移动 H5 / 组件系统、Pencil handoff、截图审查、去廉价感、动效或 shadcn-vue UI 落地时，都应使用本 skill。

根据已批准的 SpecForge tasks 执行实现；用于 implementation ready，且需要按任务边界、技术选型、UI/技术设计、验证计划落地代码并记录实现证据时。

生成或更新 SpecForge work item 的 technical_design；用于 ready artifact 为 technical_design，或需求涉及前端工程、后端架构、API、数据、权限、配置、任务或 NFR 时。

SpecForge 内部技术设计技能。用于根据 requirements 和可选 UI design 生成前端架构、后端架构、API、数据、权限、配置、NFR 和验证策略。

生成或更新 SpecForge work item 的 UI design；用于 ready artifact 为 ui_design，或需求涉及页面、交互、视觉风格、状态矩阵和 Pencil 原型证据时。

SpecForge 内部 UI 设计技能。用于根据 requirements 生成或确认视觉风格、页面地图、用户流程、交互状态和固定 Pencil 原型证据。

SpecForge Pencil 原型操作 skill；当 UI design 已确认且需要创建、读取、修改或验证 `.pen` 文件、同步 Pencil variables、复用 reusable components、导出截图、执行 snapshot_layout 或记录原型证据时必须使用。本 skill 只负责 Pencil 工具工作流和产物约束，不负责审美、token、间距、断点、Tailwind/shadcn 映射或 Product UI 设计决策。

完成 SpecForge 关闭阶段；用于当前 workflow 已到 wiki_sync / closure，需要 Wiki sync、release、rollback、doctor、archive dry-run 和 archive 时。

SpecForge 内部关闭技能。用于 wiki_sync 已批准后，写 release、rollback，确认归档前置条件，并执行 work item archive。

SpecForge 内部实现技能。用于 spec_review 已批准后，根据 tasks 的边界、依赖、验证方式和批准设计执行实现，并记录 implementation plan、report 与 changed files。

为新请求创建或整理 SpecForge 工作项；用于用户提出新需求、bug、issue、重构、预研、低风险小改或边界不清的工作，需要分类工作流、决定是否需要产品需求文档、校准组件标记，并写出可支撑下一步的简报时。

生成或刷新 SpecForge HTML 阅读报告；用于用户说“生成 HTML 报告 / 看当前需求进展 / 整理成页面 / 生成评审材料 / 只看 requirements、ui design、technical design、verification 等模块”时。用户不指定模块时自动关联当前 active work item；指定模块时生成报告并返回对应 HTML 锚点，不要求用户记命令。

SpecForge 内部 steering 技能。用于存量项目、大型代码库或 wiki 过期时建立项目画像、刷新长期上下文，并为后续 work item 提供代码事实基线。

生成或更新 SpecForge work item 的 tasks；用于 requirements、gap_report、ui_design 或 technical_design 已完成后，把规格拆成可执行、可验证、可并行的实现任务。

SpecForge 内部任务规划技能。用于 requirements、gap_report 或 technical_design 完成后生成 01-spec/tasks.md，拆解追踪来源、边界、依赖、验证和并行波次。

执行 SpecForge verification 阶段；用于 code_review 已通过后，按已批准规格、tasks、code review 结论和风险矩阵运行或收集验证证据，并批准或阻断 verification gate。

SpecForge 内部验证技能。用于证明 work item 可工作，记录 verification report、CI result、evidence links、known gaps 和重新验证条件。

更新 SpecForge 项目 Wiki；用于用户要求“回写知识库、更新 wiki、同步 Wiki”，或 close 前需要把 work item 的长期事实沉淀到 .specforge/wiki/*.md 时。

SpecForge 内部 Wiki 同步技能。用于 closure 前判断 work item 是否影响 .specforge/wiki 长期项目知识，并更新或说明不更新原因。

SpecForge 内部 discovery / intake 路由技能。用于将原始请求判断为无需 spec、单工作项、多工作项、扩展已有工作项、是否需要产品需求文档、是否需要研究或混合路线。

SpecForge 工作流根入口。用于用户只说“sf”、询问当前到哪一步、提出新需求、说继续、想自动推进或不知道该用哪个 SpecForge 能力时；本技能只扫描仓库、判断状态并路由到一个 sf-* 子技能。

SpecForge 一键推进模式；用于用户明确要求“继续做完”“自动推进”“不要停”，但仍必须保留 gate、evidence、verification 和 archive 纪律。