القائمة
生成或更新 SpecForge work item 的 technical_design；用于 ready artifact 为 technical_design，或需求涉及前端工程、后端架构、API、数据、权限、配置、任务或 NFR 时。
التثبيت باستخدام 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-tech-design |
| description | 生成或更新 SpecForge work item 的 technical_design；用于 ready artifact 为 technical_design，或需求涉及前端工程、后端架构、API、数据、权限、配置、任务或 NFR 时。 |
执行任何 node .specforge/... 命令或读取 .specforge/... 文件前，必须先定位宿主项目根：项目根是“包含 .specforge/ 目录的业务项目目录”，不是 .specforge/ 目录本身。若当前目录是 .specforge/ 或其任意子目录，先 cd .. 回到宿主项目根；若当前目录是 frontend/、backend/ 等子目录，也先向上回到包含 .specforge/ 的项目根。禁止从 .specforge/ 内执行 node .specforge/core/scripts/...，否则会形成 .specforge/.specforge/... 的错误路径。
.specforge/ 且有 active work item：Embedded 模式，按 artifact graph 写入 01-spec/technical-design.md，并遵守选型 / 依赖 / 工具链 / 核心决策 review 门禁。.specforge/ 但无 active work item：Lightweight 模式，可先做技术影响面、候选方案和风险草稿；需要落档时输出 specforge-import-ready.md 格式内容，或先路由 sf-intake 创建 work item。.specforge/：Standalone 模式，不要运行 .specforge/... 命令；输出可导入的 specforge-import-ready.md，必须区分用户已确认、沿用现有栈、用户授权默认和 Agent recommendation。sf-tech-design 把 requirements 和可选 UI design 转成可实现、可审查、可验证、可运行、可维护的工程设计。它不负责画页面线稿或决定视觉风格。
references/technical-decision-guide.md：影响面扫描、分批确认卡、依赖 / 工具链确认、版本事实检查、核心决策 review 和写作细则。references/architecture-contract.md：架构视图、ADR、实施交接、运行态、维护演进和长期约束；本次涉及架构、跨模块、API、数据、任务、权限、部署或长期维护时必须读取。.specforge/skills/sf-tech-design/stages/technical-design/SKILL.md：内部技术设计母本。.specforge/core/artifacts/templates/technical-design.md：写入骨架。.specforge/core/standards/product.md、.specforge/core/standards/workflow.md、.specforge/core/standards/engineering.md。.specforge/core/standards/ai-toolkit.md：阶段质量条、输出预算、依赖确认、source-of-truth 和证据分级。.specforge/core/skills/code-intelligence/SKILL.md：当技术设计需要现有模块入口、调用链、影响面、受影响测试、provider freshness 或 graph_facts[] 时读取；优先用 Wiki bounded context，再局部查询 provider。.specforge/core/profiles/README.md：技术选型维度、数据库选择矩阵和 profile selection 写法。.specforge/core/skills/ui-ux/design-system/SKILL.md、.specforge/core/skills/ui-ux/design-system/references/read-profiles.md#Full-System Orchestration、.specforge/core/skills/ui-ux/design-system/references/output-contract.md；再按需读 .specforge/core/skills/ui-ux/design-system/components/component-system.md、.specforge/core/skills/ui-ux/design-system/foundations/foundation-system.md、.specforge/core/skills/ui-ux/design-system/references/motion-block-library.md。node .specforge/core/scripts/instructions.mjs
Instructions blocked，按 Route 处理阻断。尤其当 blocker 为 tech-direction-unconfirmed、dependency-decision-unconfirmed 或 tooling-decision-unconfirmed 时，停止 technical design，向用户输出确认卡。technical_design 后，再运行：node .specforge/core/scripts/create-artifact.mjs technical_design
00-intake/brief.md、00-intake/prd.md（如果存在）、00-intake/brainstorm.md（如果存在）、01-spec/requirements.md、01-spec/ui-design.md（如果存在）、.specforge/wiki/00-index.md 和相关 .specforge/wiki/。sf-steering，不要在 technical design 中临时全量探索。references/technical-decision-guide.md#影响面扫描 标记 frontend、backend、domain、API、data、auth/security、config/delivery、jobs、observability、reliability。node .specforge/core/scripts/graph-freshness.mjs --json；ready 后按 .specforge/core/skills/code-intelligence/references/stage-integration.md#sf-tech-design 查询并归一 graph_facts[]。yes / no / unknown；会改变架构、数据、安全、成本或上线风险的 unknown 必须暂停澄清。.specforge/skills/sf-tech-design/stages/technical-design/frontend-design.md.specforge/skills/sf-tech-design/stages/technical-design/backend-design.md.specforge/skills/sf-tech-design/stages/technical-design/domain-design.md.specforge/skills/sf-tech-design/stages/technical-design/api-design.md.specforge/skills/sf-tech-design/stages/technical-design/data-design.md.specforge/skills/sf-tech-design/stages/technical-design/nfr-design.md[NEEDS TECH/DEPENDENCY/TOOLING DECISION] 维度未确认，不得写架构设计正文。references/technical-decision-guide.md#分批确认卡 输出候选方案，等用户确认。references/technical-decision-guide.md#新增依赖确认 单独确认。[TECH DECISION CONFIRMED]、[DEPENDENCY DECISION CONFIRMED]、[TOOLING DECISION CONFIRMED] 或对应状态：existing_stack、delegated_default、scaffold_confirmed、not_required。01-spec/technical-design.md。references/technical-decision-guide.md#当前版本事实检查 查询官方资料或读取 lockfile / manifest。references/architecture-contract.md：选择本次需要的最小 Architecture View（Context / Container / Component / Runtime / Data / Deployment），写清 boundary、responsibility、interface、state、data、security、operability、delivery、testability、maintainability 和 cost 中适用维度。Design Quality Gate：设计规模、现有架构复用、新增依赖确认、更简单方案、契约可测试性和是否可拆 tasks。ui-design.md#Design Contract Summary 转成工程决策：token delivery、component source、project wrapper、shadcn-vue registry boundary、motion source、state ownership 和 visual verification hooks。N/A - no long-lived architecture decision。sf-tasking：每个技术决策都要能拆成任务、验证或明确 N/A。references/technical-decision-guide.md#核心决策摘要 Review，等待确认、调整或授权默认。sf-tasking、sf-spec-review approval 或 sf-implement。technical-design.md#1. 技术选型与依赖确认 写 Core Decision Review Status: confirmed 或 delegated_default / not_required，并保留 [TECH DESIGN REVIEW CONFIRMED]。node .specforge/core/scripts/artifact-quality.mjs
Issues：technical_design 相关 FAIL 必须修复，尤其是 open decision、关键影响面 unknown、Architecture Contract / Implementation Handoff / Operability & Maintenance 空壳；WARN 必须修复或在 Design Quality Gate 中写明 owner、影响和接受理由。| 条件 | 状态 |
|---|---|
| 技术方向尚未确认 | 停止：确认技术方向 |
| 新增 / 替换依赖尚未确认 | 停止：确认新增 / 替换依赖 |
| 工具链选择尚未确认 | 停止：确认包管理器、组件库、依赖管理、测试工具等 |
| requirements 仍有阻断歧义 | 停止：上游需求需先澄清 |
| 存量项目 wiki 无法给出本次相关入口、边界或上下游 | 停止：路由 sf-steering 刷新 wiki |
| 新项目、空仓库或关键技术缺失，但没有确认来源 | 停止 |
| 新增 / 替换技术或依赖缺少版本事实、官方资料、lockfile 证据或明确风险说明 | 停止 |
| UI 有前端实现影响，但 technical design 未承接 Design Contract Summary、token delivery、组件架构、动效来源或视觉验证面 | 停止 |
| 跨模块 / API / 数据 / 权限 / 任务 / 集成 / 运行变更缺少 Architecture Contract、Implementation Handoff 或 Maintenance & Evolution | 停止 |
| 设计只描述 happy path，没有失败模式、回滚、观察点或验证路径 | 停止 |
technical-design.md 仍残留 [NEEDS TECH DECISION]、[NEEDS DEPENDENCY DECISION] 或 [NEEDS TOOLING DECISION] | 停止 |
Core Decision Review Status 不是 confirmed、delegated_default 或 not_required | 停止 |
01-spec/technical-design.md 存在。Design Quality Gate 证明设计最小充分、没有无根据新增依赖，且关键契约可测试。artifact-quality.mjs 的 technical_design 相关 FAIL 已清零；WARN 已修复或在 Design Quality Gate 中有明确接受理由。Tech Profile Selection、Requirements Trace、核心决策摘要 Review 等章节可省略或合并为一行摘要；沿用现有栈时不需要重复列出所有技术选型表格。目标是让文档可读可审批，而不是填满模板。node .specforge/core/scripts/instructions.mjs，将输出展示给用户，让用户知道当前 workflow 的下一步是什么。ui-design.md。