القائمة
文档落地治理规范。统一管理 docs/ 目录下文档的写时约束、读时索引、生命周期标记。提供当前真相源白名单（doc-paths.md）+ frontmatter schema + 新项目一键脚手架（init-project.sh，已就绪）。所有 forge-* skill 的文档落地路径以本 skill 的 doc-paths.md 为准。触发方式：用户说"文档治理"、"文档放哪"、"docs 目录乱了"、"forge-doc-policy"、AI 准备创建任意 .md 或新目录前的自查。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Forge 工作流总入口。只读检测项目状态，推荐下一步该用哪个 skill，自己不干活。触发方式：用户说"forge"、"下一步"、"接下来做什么"。
复盘 v3（Workbench 门禁型）：启动本地 Workbench，用户在独立会话页确认想学的知识点和深度，按选择调研产出复盘文档； 同时落 2-3 条账本条目（记录/复盘/learnings.jsonl）供 bugfix/eng 开工回放与复发检测。 触发方式：用户说"总结知识"、"学习总结"、"复盘"、"可视化复盘"、"/forge-fupan"。
通用头脑风暴：4 种模式（产品/内容/构建/探索）× 6 阶段，强制前提挑战和 2-3 方案，产出可跨会话续聊的思考文档；支持 Mermaid/图辅助判断。 触发方式：用户说"头脑风暴"、"brainstorm"、"讨论一下"、"我有个想法"、"帮我想想"、"画图梳理想法"。
设计实现：把 DESIGN.md 转成代码，只改样式不改逻辑；CSS 优先、Token 驱动、反 AI 模板、原子提交，以真实截图和 CSS 断言验证。 触发方式：用户说"实现设计"、"forge-design-impl"、设计文档确认后需要写代码时。
全栈设计规划：分级门控管理 DESIGN.md 与 DESIGN-CHANGELOG，内置可检索设计规则库（UX 规则/配色/字体），三层 Token、Image 2 视觉稿门禁、反 AI 模板检测。 触发方式：用户说"设计"、"forge-design"、"先看效果图"，或 forge-dev 调度、需要创建/更新设计文档时。
发布后文档更新。读取所有项目文档，与 diff 交叉对照， 更新 README/ARCHITECTURE/CONTRIBUTING/CLAUDE.md 使之匹配已发布内容， 润色 CHANGELOG 语气，清理 TODOS，可选地更新 VERSION。 触发方式：用户说"更新文档"、"文档同步"、"forge-doc-release"，或 forge-ship 之后、PR 合并之前由 forge-dev --full 调度。
| name | forge-doc-policy |
| description | 文档落地治理规范。统一管理 docs/ 目录下文档的写时约束、读时索引、生命周期标记。提供当前真相源白名单（doc-paths.md）+ frontmatter schema + 新项目一键脚手架（init-project.sh，已就绪）。所有 forge-* skill 的文档落地路径以本 skill 的 doc-paths.md 为准。触发方式：用户说"文档治理"、"文档放哪"、"docs 目录乱了"、"forge-doc-policy"、AI 准备创建任意 .md 或新目录前的自查。 |
这是一个规范型 skill，不主动产出代码或文档，作为其他 forge-* skill 和 LLM 自觉行为的当前真相源。
全程中文。
解决三层文档治理痛点：
| 层级 | 痛点 | 本 skill 提供 |
|---|---|---|
| 写时约束 | AI 创建文档时落到错位置（forge skill 部分约束 + CLAUDE.md 表不全 + 直接对话完全无约束） | doc-paths.md 三层白名单 + LLM 强校验铁律 |
| 读时索引 | 文档分散，找不到最新信息 | frontmatter-schema.md（索引自动生成脚本规划中，见 CHANGELOG Roadmap） |
| 生命周期 | 不带元数据，分不清活/死文档 | frontmatter-schema.md 必填字段（批量回填脚本规划中，见 CHANGELOG Roadmap） |
| 文件 | 作用 |
|---|---|
SKILL.md | 本文件，元信息和装载说明 |
doc-paths.md | 当前真相源、模块附录、active 工作区、archive 白名单 |
frontmatter-schema.md | frontmatter 字段定义（4 必填 + 2 选填） |
claude-md-snippet.md | 项目 CLAUDE.md 复制粘贴的引用段 |
CHANGELOG.md | 版本号 + 演进记录 + 规划中的能力（Roadmap） |
scripts/init-project.sh | 新项目 day 0 一键脚手架（幂等，绝不覆盖） |
规划中但未实现的脚本/模板（audit-project.sh、build-index.sh 等）见 CHANGELOG.md 的 Roadmap 节，不出现在本清单，避免被误引导执行。
每个项目的 CLAUDE.md（项目根 / ~/claudecode_workspace/CLAUDE.md）加 3 行引用段，详见 claude-md-snippet.md。
Why：规则源头在本 skill，所有项目通过引用读取，不复制副本。
~/.claude/skills/forge-doc-policy/scripts/init-project.sh
在新项目根跑一次：创建 docs/ 标准骨架 + 拷贝 CLAUDE.md 模板 + 配 .gitignore + 生成 docs/README.md。
init-project.sh 幂等且绝不覆盖已有文件，老项目也可安全跑一遍补齐缺失骨架doc-paths.md 白名单核对本段被
claude-md-snippet.md引用，写进每个项目 CLAUDE.md。
doc-paths.md 的层 1 白名单内Why 不上 PreToolUse hook：Hook 误伤会让用户频繁被打断，3 次就会自己关掉，反而失效。LLM 自觉 + 违规才问 = 更友好且对 forge skill 已有约束的补强。（决策渊源见 CHANGELOG）
| 用户说 | 行为 |
|---|---|
| "文档治理" / "forge-doc-policy" | 进入本 skill，按用户具体诉求路由（查白名单 / 装载 / 审计） |
| "文档放哪" / "这个文档应该放哪" | 读 doc-paths.md 给路径建议 |
| "docs 目录乱了" / "想清理文档" | 按 doc-paths.md 白名单人工核对 |
| AI 准备创建任意 .md 或新目录 | 自查 doc-paths.md 三层白名单（LLM 强校验铁律） |
| skill | 关系 |
|---|---|
| 14 个 forge-* skill | 顶部加引用 > 文档落地路径见 forge-doc-policy/doc-paths.md，原 skill 私有路径合并到当前真相源体系 |
forge-cookbook _shared/ | 不重复造轮子。_shared/visual-decision-layer.md 等保留；本 skill 只管文档落地路径 |
| 项目 CLAUDE.md / 工作区 CLAUDE.md | 引用本 skill 的 claude-md-snippet.md，不在 CLAUDE.md 重复规则 |
CHANGELOG.mdforge-doc-policy@v0.2），规则改动走独立 worktree → 在关联项目手动核对影响 → 没炸再合 main