sf-requirements

运行目录

执行任何 node .specforge/... 命令或读取 .specforge/... 文件前，必须先定位宿主项目根：项目根是“包含 .specforge/ 目录的业务项目目录”，不是 .specforge/ 目录本身。若当前目录是 .specforge/ 或其任意子目录，先 cd .. 回到宿主项目根；若当前目录是 frontend/、backend/ 等子目录，也先向上回到包含 .specforge/ 的项目根。禁止从 .specforge/ 内执行 node .specforge/core/scripts/...，否则会形成 .specforge/.specforge/... 的错误路径。

运行模式检测

1. 当前目录向上存在 .specforge/ 且有 active work item：Embedded 模式，按 artifact graph 写入 01-spec/requirements.md。
2. 存在 .specforge/ 但无 active work item：Lightweight 模式，可把用户提供的简报 / 产品需求文档草稿整理成需求规格草稿；需要落档时输出 specforge-import-ready.md 格式内容，或先路由 sf-intake 创建 work item。
3. 不存在 .specforge/：Standalone 模式，不要运行 .specforge/... 命令；输出 specforge-import-ready.md 格式内容，保留 SHALL 需求、AC、非目标、影响面建议和未决问题，后续由 sf-intake 导入。

sf-requirements 把简报（和可选产品需求文档）升级为可测试、可审查、可路由到后续设计阶段的需求规格。它不写界面方案、接口方案、数据库方案或实现任务。

必读