菜单
SpecForge requirements 主能力包。用于把 brief、brainstorm、PRD、research、gap report、wiki 当前事实和用户确认转成可测试、可追踪、可交给 UI / technical design / tasking / verification 的 REQ / AC / NFR / 边界 / handoff 行为契约。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
生成或更新 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。
| name | requirements |
| description | SpecForge requirements 主能力包。用于把 brief、brainstorm、PRD、research、gap report、wiki 当前事实和用户确认转成可测试、可追踪、可交给 UI / technical design / tasking / verification 的 REQ / AC / NFR / 边界 / handoff 行为契约。 |
本 skill 负责 requirements 的“行为契约层”。它不是 PRD、不是技术设计、不是 backlog 工具；它把上游已确认的产品意图、范围边界、研究事实、既有系统约束和风险，转成可测试、可追踪、可审查、可交接的系统行为规格。
核心定位：产品输入进来，工程可执行输出出去。
sf-requirements 需要把 brief / brainstorm / PRD / research / gap report 转成 01-spec/requirements.md。user-confirmed、delegated-default、agent-recommendation、pending 等不同确认状态，需要判断哪些能进入 MUST / SHALL。references/output-contract.md，确认 compact / standard / full 输出 profile 和 requirements.md 的固定结构。references/behavior-contract.md，建立 confirmation boundary、requirement language、testability、traceability 和 NFR 边界。references/source-translation.md，把 brief / brainstorm / PRD / research / gap / wiki 输入转成 REQ / AC / NFR / Out of Scope / Pending / Deferred。references/coverage-patterns.md 的相关 pattern：role-permission、workflow-state、data-file、ai-quality、ui-impact、integration-api、runtime-ops。references/handoff-and-authoring.md，建立 Source -> REQ -> AC -> downstream trace，并使用访谈 / 验收标准 / ambiguity review 模板。references/quality-guide.md，按 artifact-quality 和 anti-pattern fixer 做需求质量审查。| 能力 | 作用 | 产出 |
|---|---|---|
| Behavior contract | 判断哪些上游输入可进入需求，并规范 MUST / SHOULD / MAY、EARS、AC 和 trace | 上游确认输入、REQ-*、AC-*、trace |
| Source translation | PRD / brainstorm / research / gap / wiki 转译 | Source -> Requirement 转译 |
| Coverage patterns | 权限、状态、数据、AI、UI、集成、运行时覆盖 | Applied Requirement Patterns、行为覆盖矩阵、NFR |
| Handoff and authoring | 验收标准、访谈、下游交接和歧义检查 | AC-*、Downstream Handoff、未决问题 |
| Quality review | 用 artifact-quality 对齐规则和 anti-pattern fixer 检查歧义、不可测试、范围蔓延、实现细节 | Spec Quality Gate |
| 内容 | 写入位置 |
|---|---|
| Requirements Control、来源、确认策略、输出 profile | 01-spec/requirements.md#0. Requirements Control |
| 上游确认输入、Agent recommendation 边界 | 01-spec/requirements.md#1. 上游确认输入 |
| Source -> Requirement 转译 | 01-spec/requirements.md#2. Source -> Requirement 转译 |
| REQ / AC / NFR / non-goal / pending | 01-spec/requirements.md 对应章节 |
| 影响面 flags、UI / technical design 触发 | 01-spec/requirements.md#影响面确认、brief.md / work.yaml |
| 下游交接 | 01-spec/requirements.md#Downstream Handoff |
user-confirmed 和 delegated-default 转成 MUST / SHALL；agent-recommendation 只能进候选、推荐或 pending。requirements.md 能证明每条需求来自已确认输入、授权默认或当前事实。node .specforge/core/scripts/artifact-quality.mjs 的 requirements FAIL 已清零；WARN 已修复或写入 Spec Quality Gate。