Menu
SpecForge 内部 Wiki 同步技能。用于 closure 前判断 work item 是否影响 .specforge/wiki 长期项目知识，并更新或说明不更新原因。
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ê.
Baseado na classificação ocupacional 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 | wiki-sync |
| description | SpecForge 内部 Wiki 同步技能。用于 closure 前判断 work item 是否影响 .specforge/wiki 长期项目知识，并更新或说明不更新原因。 |
本技能在 closure 前判断 work item 是否影响长期项目知识，并更新 .specforge/wiki/ 或说明不需要更新。它是防止“代码已变、知识库过期”的收口步骤。Wiki 只保存当前事实，不保存过程流水账。
01-spec/requirements.md00-intake/prd.md（存在时）01-spec/ui-design.md（存在时）01-spec/technical-design.md（存在时）02-spec-review/spec-review-v1.md（存在时）03-implementation/report.md04-code-review/code-review-v1.md05-verification/report.md.specforge/wiki/.specforge/core/standards/wiki.md.specforge/core/standards/engineering.md.specforge/core/standards/workflow.md.specforge/core/standards/ai-toolkit.md.specforge/core/standards/pc-ui-design-spec.md（本次确认或落地 PC 端业务系统 UI 规范时）node .specforge/core/scripts/wiki-update-plan.mjs --json 输出06-close/wiki-sync.md.specforge/wiki/01-project-overview.md.specforge/wiki/02-product-rules.md.specforge/wiki/03-architecture.md.specforge/wiki/module-<name>.md.specforge/wiki/api-<domain>.md.specforge/wiki/external-interfaces.md.specforge/wiki/integration-<system>.md.specforge/wiki/config-env.md.specforge/wiki/security-auth.md.specforge/wiki/jobs-events.md.specforge/wiki/design-system.md.specforge/wiki/04-data-model.md.specforge/wiki/05-operations.md.specforge/wiki/06-decisions.md.specforge/wiki/07-glossary.md.specforge/wiki/08-risks.md.specforge/wiki/00-index.md| 变化类型 | 目标文件 |
|---|---|
| 项目目标、用户、整体状态 | 01-project-overview.md |
| 产品规则、角色、权限、审批、状态机 | 02-product-rules.md |
| 架构、模块边界、技术栈、关键数据流 | 03-architecture.md 或 module-<name>.md |
| API、事件、Webhook、SDK 契约 | api-<domain>.md |
| 对外接口总览、第三方集成、CLI、文件导入导出、公开前端入口 | external-interfaces.md / integration-<system>.md |
| 核心实体、表、关系、状态、迁移注意事项 | 04-data-model.md |
| 环境、配置、启动、任务、发布、回滚、观测 | 05-operations.md |
| 环境变量、secret、feature flag、配置源 | config-env.md |
| 认证、授权、权限、敏感数据边界 | security-auth.md |
| 后台任务、队列、事件、定时任务、消息契约 | jobs-events.md |
| 稳定 UI 组件、token、设计系统、风格规则、PC 端业务系统规范落地规则 | design-system.md |
| 长期架构 / 产品 / 技术决策 | 06-decisions.md |
| 术语、缩写、领域语言 | 07-glossary.md |
| 已知风险、技术债、后续事项 | 08-risks.md |
不进入 wiki 的内容：一次性调试记录、命令长日志、截图、未批准草稿、只对本 work item 有意义的实现备注。
node .specforge/core/scripts/wiki-update-plan.mjs --json。
wiki_state、long_term_fact_candidates、required_targets、can_write_na、blocking_gaps 写入 06-close/wiki-sync.md。can_write_na=false，不得写 N/A - 无长期事实。missing / bootstrap，先运行 node .specforge/core/scripts/wiki-hydrate.mjs --mode close --write，再补充人工可确认事实。node .specforge/core/scripts/wiki-refresh-plan.mjs --from-diff --json；若返回 wiki_update_needed=true，把 targets 写入 wiki-sync.md#2-必须更新的-wiki-目标。technical-design.md#7.1 Architecture Contract、#Implementation Handoff、#12. Operability & Maintenance 提取 owner、boundary、interface、operability、extension point、deprecation path、wiki target、technical debt 和 revisit trigger。can_write_na=true 且 wiki refresh plan 没有必须更新目标时，才允许写 N/A - 无长期事实，不要把过程流水账塞进 wiki。00-index.md，判断是更新当前事实、补充新章节，还是写 N/A。.specforge/core/standards/wiki.md#最低完整度 检查目标文件。架构、API、数据、运维文件缺少关键事实时，先补扫相关代码 / 配置 / 测试；仍缺失时写 未确认，并同步到 08-risks.md 或本次 wiki-sync 的缺口表。
04-data-model.md#历史--未受信-sql-产物 或 08-risks.md。06-decisions.md 或目标文件中保留必要决策理由。last_updated、source_work 和 status: current。00-index.md；不得产生重复 current 条目。node .specforge/core/scripts/wiki-quality.mjs --mode close。FAIL 必须修复；WARN 必须写接受理由、影响和补证路径。wiki-update-plan 的 can_write_na、required_targets 和 blocking_gaps。status: current，除非被明确替代。design-system.md；不更新时说明该规范是否只是一次性页面约束。.specforge/wiki/00-index.md 的当前知识项、摘要和最后同步时间。wiki-quality.mjs --mode close 的结果。wiki-update-plan 输出 can_write_na=false 但未更新 required targets。wiki-quality.mjs --mode close 仍有 FAIL。wiki-sync.md 存在。00-index.md 已列出所有 current 知识项和最后同步时间。未确认 并进入风险 / 缺口记录。wiki-update-plan 与实际更新文件一致；wiki-quality.mjs --mode close 无 FAIL。wiki_sync gate 可以被批准或有明确阻断原因。