القائمة
更新 SpecForge 项目 Wiki；用于用户要求“回写知识库、更新 wiki、同步 Wiki”，或 close 前需要把 work item 的长期事实沉淀到 .specforge/wiki/*.md 时。
التثبيت باستخدام 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-wiki |
| description | 更新 SpecForge 项目 Wiki；用于用户要求“回写知识库、更新 wiki、同步 Wiki”，或 close 前需要把 work item 的长期事实沉淀到 .specforge/wiki/*.md 时。 |
执行任何 node .specforge/... 命令或读取 .specforge/... 文件前，必须先定位宿主项目根：项目根是“包含 .specforge/ 目录的业务项目目录”，不是 .specforge/ 目录本身。若当前目录是 .specforge/ 或其任意子目录，先 cd .. 回到宿主项目根；若当前目录是 frontend/、backend/ 等子目录，也先向上回到包含 .specforge/ 的项目根。禁止从 .specforge/ 内执行 node .specforge/core/scripts/...，否则会形成 .specforge/.specforge/... 的错误路径。
sf-wiki 维护项目当前长期事实，不复制 work item 过程流水账。Wiki 是项目记忆，也是后续任务的入口地图，不是 implementation report、verification report 或 release note 的第二份副本。
如果用户目标是“先理解整个存量项目 / 建立项目画像 / 扫描大型代码库”，优先路由 sf-steering。sf-wiki 负责把已确认事实或完成 work item 的结论同步成当前 wiki。
references/wiki-sync-rules.md：回写判断、目标文件选择、frontmatter、index 对账、gate 决策。.specforge/skills/sf-wiki/stages/wiki-sync/SKILL.md.specforge/core/artifacts/templates/wiki-sync.md.specforge/core/standards/wiki.md.specforge/core/standards/workflow.md.specforge/core/standards/engineering.md.specforge/core/standards/ai-toolkit.md.specforge/core/standards/design.md 和 .specforge/core/standards/pc-ui-design-spec.md。.specforge/core/skills/ORCHESTRATION.md，只沉淀已被 SpecForge artifact 证实的稳定内容。node .specforge/core/scripts/instructions.mjs
wiki_sync，生成 evidence：node .specforge/core/scripts/create-artifact.mjs wiki_sync
.specforge/wiki/ 缺少基础文件，先补齐：node .specforge/core/scripts/sync-wiki.mjs
06-close/wiki-sync.md 或判断 N/A 前，必须先生成机器计划：node .specforge/core/scripts/wiki-update-plan.mjs --json
若输出 can_write_na=false，不得写 N/A - 无长期事实；必须更新 required_targets 或写明阻断缺口。若 wiki 仍处于 missing / bootstrap 且当前 work item verification 已批准，先运行：
node .specforge/core/scripts/wiki-hydrate.mjs --mode close --write
优先读取 active work 的最终产物：
00-intake/brief.md00-intake/prd.md（存在时）01-spec/requirements.md01-spec/gap-report.md（存在时）01-spec/ui-design.md（存在时）01-spec/technical-design.md（存在时）00-steering/codebase-intelligence.md（存在时）node .specforge/core/scripts/wiki-refresh-plan.mjs --from-diff --json（implementation / verification 后判断长期 Wiki 目标）02-spec-review/spec-review-v1.md（存在时）03-implementation/report.md04-code-review/code-review-v1.md05-verification/report.md06-close/release.md / rollback.md（存在时）wiki-update-plan.mjs --json，把 wiki_state、long_term_fact_candidates、required_targets、can_write_na 和 blocking_gaps 写入 06-close/wiki-sync.md#0 到 #2。references/wiki-sync-rules.md#回写矩阵 判断目标文件，并与 required_targets 对账。ai-toolkit.md#持续演进 判断是否至少有一个可复用事实；只有 can_write_na=true 且候选事实都已说明不复用时，才允许写 N/A - 无长期事实。06-close/wiki-sync.md 写 N/A 理由，不更新 wiki。external-interfaces.md；接口域详情按需写 api-<domain>.md，第三方系统详情按需写 integration-<system>.md。config-env.md。security-auth.md。jobs-events.md。04-data-model.md#历史--未受信-sql-产物 或 08-risks.md。wiki-refresh-plan.mjs --from-diff --json 返回 wiki_update_needed=true，必须把 targets 写入 wiki-sync.md#2-必须更新的-wiki-目标，更新对应 Wiki 或写阻断原因。technical-design.md#7.1 Architecture Contract、#Implementation Handoff 或 #12. Operability & Maintenance 声明了 owner、extension point、deprecation path、wiki target、technical debt 或 revisit trigger，必须按其 wiki target 回写或在 wiki-sync.md 写明可信 N/A。module-<name>.md、api-<domain>.md、design-system.md。title、kind、owner、last_updated、source_work、status。references/wiki-sync-rules.md#Wiki 质量清单 检查信息密度；架构、模块、API、数据、运维类文件不能只写概述，还要能支持后续任务从 wiki 入手定位代码。rg / provider / 关键配置读取查找路由、模型、migration、服务入口、脚本和测试。仍无法确认的，写 未确认 并同步到 08-risks.md。.specforge/wiki/00-index.md 的摘要、当前文件索引和最后同步时间。06-close/wiki-sync.md 记录更新文件、写入事实、来源证据、不更新原因、未确认缺口和下游重新验证要求。node .specforge/core/scripts/wiki-quality.mjs --mode close
FAIL 必须修复；WARN 必须在 wiki-sync.md#8-质量检查结果 记录接受理由或后续补证路径。
批准：
node .specforge/core/scripts/gate.mjs wiki_sync APPROVED --evidence 06-close/wiki-sync.md
缺少事实证据或冲突未解决：
node .specforge/core/scripts/gate.mjs wiki_sync REQUEST_CHANGES
| 条件 | 状态 |
|---|---|
| verification 未批准，且处于 close 前 wiki_sync | 停止，回 sf-verify |
| 只是一次性过程记录、日志、截图、临时调试 | 不更新 wiki，写 N/A 理由 |
wiki-update-plan 输出 can_write_na=false | 必须更新 required targets 或阻断，不得 N/A |
| 已验证 work item 后 wiki 仍为 bootstrap | 先 wiki-hydrate --mode close --write，再人工补证 |
| 长期产品 / 架构 / API / 数据 / 运行 / 设计系统 / 风险变化 | 更新对应 wiki |
| technical design 声明 wiki target、owner、extension point、deprecation path、technical debt 或 revisit trigger | 更新对应 wiki / 08-risks.md / 06-decisions.md |
| artifact 与现有 wiki 冲突且无法判断最新事实 | REQUEST_CHANGES |
| 会产生重复 current 文件 | 停止，合并到唯一目标文件 |
06-close/wiki-sync.md 写明影响或不影响。status: current 正确。.specforge/wiki/00-index.md 反映最新 current 文件列表。06-decisions.md。未确认，并在 08-risks.md 或 06-close/wiki-sync.md 记录补证路径。wiki-update-plan 的 required_targets 已更新或有阻断说明，且 wiki-quality.mjs --mode close 无 FAIL。node .specforge/core/scripts/instructions.mjs，将输出展示给用户，让用户知道当前 workflow 的下一步是什么。