forge
무료Forge 工作流总入口。只读检测项目状态，推荐下一步该用哪个 skill，自己不干活。触发方式：用户说"forge"、"下一步"、"接下来做什么"。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
antonailog/forge-skills132026년 10월 21일 업데이트
무료GitHub에 공개
forge-doc-policy
文档落地治理规范。统一管理 docs/ 目录下文档的写时约束、读时索引、生命周期标记。提供当前真相源白名单（doc-paths.md）+ frontmatter schema + 新项目一键脚手架（init-project.sh，已就绪）。
所有 forge-* skill 的文档落地路径以本 skill 的 doc-paths.md 为准。触发方式：用户说"文档治理"、"文档放哪"、"docs 目录乱了"、"forge-doc-policy"、AI 准备创建任意 .md 或新目录前的自查。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치 방법 보기포함된 파일(10)
- SKILL.md5.0 KB
- CHANGELOG.md3.5 KB
- claude-md-snippet.md3.2 KB
- doc-paths.md6.5 KB
- frontmatter-schema.md4.5 KB
- hooks/.gitkeep86 B
- README.md2.3 KB
- scripts/.gitkeep131 B
- scripts/init-project.sh5.5 KB
- templates/.gitkeep107 B
SKILL.md(원문)
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
/forge-doc-policy：文档落地治理规范
这是一个规范型 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 节，不出现在本清单，避免被误引导执行。
装载方式（三选一，按场景）
装载 1：项目 CLAUDE.md 引用（当前主装载，Sprint A）
每个项目的 CLAUDE.md（项目根 / ~/claudecode_workspace/CLAUDE.md）加 3 行引用段，详见 claude-md-snippet.md。
Why：规则源头在本 skill，所有项目通过引用读取，不复制副本。
装载 2：新项目 day 0（✅ 已就绪）
~/.claude/skills/forge-doc-policy/scripts/init-project.sh
在新项目根跑一次：创建 docs/ 标准骨架 + 拷贝 CLAUDE.md 模板 + 配 .gitignore + 生成 docs/README.md。
装载 3：老项目接入（手动方式）
init-project.sh幂等且绝不覆盖已有文件，老项目也可安全跑一遍补齐缺失骨架- frontmatter 缺失、目录偏差人工按
doc-paths.md白名单核对
LLM 强校验铁律（每次创建 .md / 新目录前必须执行）
本段被
claude-md-snippet.md引用，写进每个项目 CLAUDE.md。
- 自查 — 核对目标路径是否在
doc-paths.md的层 1 白名单内 - 违规处理 — 若不在白名单 / 介于多个目录 / 涉及新分类 → 停下问用户（给 2-3 个候选路径）
- 合规处理 — 在白名单内 → 静默写入，不打断用户
- 铁律 — 违反 1-3 的写入即视为 bug，用户报告后 AI 必须立即移动文件 + 在 memory 加 feedback
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 强校验铁律） |
与其他 forge-* skill 的关系
| 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 重复规则 |
版本与演进
- v0.2（2026-06-09）适配根级当前真相源、模块附录、active bugfix 后归档和 archive/raw 结构。
- v0.1（2026-04-28）骨架 + 文档规则源头 + claude-md-snippet（Sprint A.1）
- 后续版本演进见
CHANGELOG.md - 项目 CLAUDE.md 引用时锁版本号（如
forge-doc-policy@v0.2），规则改动走独立 worktree → 在关联项目手动核对影响 → 没炸再合 main
리뷰
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
댓글
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
같은 저장소의 스킬
通用头脑风暴：4 种模式（产品/内容/构建/探索）× 6 阶段，强制前提挑战和 2-3 方案，产出可跨会话续聊的思考文档；支持 Mermaid/图辅助判断。 触发方式：用户说"头脑风暴"、"brainstorm"、"讨论一下"、"我有个想法"、"帮我想想"、"画图梳理想法"。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
antonailog/forge-skills132026년 10월 21일 업데이트
系统性 Bug 修复流水线（P0-P8）：一次修一个，强制根因分析、独立 worktree、TDD、双层验收报告、forge-qa 回归；多会话经 .forge/active.md 防撞车。 铁律：不做根因分析不写代码；新发现禁止顺手修；没有用户最终结论不合并。 触发方式：用户说"bugfix"、"反馈个问题"、"修这个 bug"、"这里有问题"、"为什么不对"、"排查一下"、"investigate"、"forge-bugfix"，或报告错误、异常行为、功能失效时。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
antonailog/forge-skills132026년 10월 21일 업데이트
端到端交付纯编排层：调用 forge-* 子 skill 从需求一路编排到发布和文档，.deliver/state.json 检查点，支持 --auto / --resume。 触发方式：用户说"forge-deliver"、"端到端交付"、"全自动交付"。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
antonailog/forge-skills132026년 10월 21일 업데이트
全栈设计规划：分级门控管理 DESIGN.md 与 DESIGN-CHANGELOG，内置可检索设计规则库（UX 规则/配色/字体），三层 Token、forge-design-lab 工作台门禁（布局/比例/密度在真 token 骨架上定，Image 2 退为气质稿）、反 AI 模板检测。 触发方式：用户说"设计"、"forge-design"、"先看效果图"，或 forge-dev 调度、需要创建/更新设计文档时。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
antonailog/forge-skills132026년 10월 21일 업데이트
设计实现：把 DESIGN.md 转成代码，只改样式不改逻辑；CSS 优先、Token 驱动、反 AI 模板、原子提交，以真实截图和 CSS 断言验证。 触发方式：用户说"实现设计"、"forge-design-impl"、设计文档确认后需要写代码时。
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
antonailog/forge-skills132026년 10월 21일 업데이트