Menu
更新 SpecForge 项目 Wiki；用于用户要求“回写知识库、更新 wiki、同步 Wiki”，或 close 前需要把 work item 的长期事实沉淀到 .specforge/wiki/*.md 时。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
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。
Baseado na classificação ocupacional SOC
| 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 的下一步是什么。