forge-doc-policy SKILL.md skillA

This file is byte-identical to the first copy the registry indexed. Same content hash, so the same checks give both the same grade.

forge-doc-policy from antonailog/forge-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add antonailog/forge-skills/forge-doc-policy@git:20260717.95d1b1c

Pins git:20260717.95d1b1c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
antonailog/forge-skills
Path
skills/forge-doc-policy/SKILL.md
Versions recorded
5
Latest version
git:20260717.95d1b1c, committed Jul 17, 2026
First version recorded
Jul 4, 2026
Size
5,078 bytes
Repository stars
13
License
MIT

文档落地治理规范。统一管理 docs/ 目录下文档的写时约束、读时索引、生命周期标记。提供当前真相源白名单(doc-paths.md)+ frontmatter schema + 新项目一键脚手架(init-project.sh,已就绪)。所有 forge-* skill 的文档落地路径以本 skill 的 doc-paths.md 为准。触发方式:用户说"文档治理"、"文档放哪"、"docs 目录乱了"、"forge-doc-policy"、AI 准备创建任意 .md 或新目录前的自查。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# /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(✅ 已就绪)

```bash
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add antonailog/forge-skills/forge-doc-policy@sha256:866fcb4de34cbfef

The line at the top of this page pins the label git:20260717.95d1b1c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_upabo27czqgdfm4f.svg)](https://markdownregistry.com/a/art_upabo27czqgdfm4f)

0 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jul 4, 2026 and Jul 17, 2026, about one every 3 days.

versioncommittedcommitsizeaudit
git:20260717.95d1b1c latest2026-07-17 95d1b1c 5,078 BA view · diff
git:20260717.f9c3c902026-07-17 f9c3c90 5,148 BA view · diff
git:20260704.d60f8d12026-07-04 d60f8d1 5,829 BA view · diff
git:20260704.254eec32026-07-04 254eec3 5,568 BA view · diff
git:20260704.4925ded2026-07-04 4925ded 5,566 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5078 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

antonailog/forge-skills · 13 stars · license MIT · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_upabo27czqgdfm4f
GET https://markdownregistry.com/api/v1/resolve?ref=antonailog/forge-skills/forge-doc-policy
GET https://markdownregistry.com/api/v1/blob/866fcb4de34cbfefd202b85cb8eda4402934c980759d00196f409a88c8e4b4c7

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from antonailog/forge-skills

forge SKILL.md skill
antonailog/forge-skills · SKILL.md · Forge 工作流总入口。只读检测项目状态,推荐下一步该用哪个 skill,自己不干活。触发方式:用户说"forge"、"下一步"、"接下来做什么"。
git:20261010.1c72700 · audit A · 13 stars
forge-deliver SKILL.md skill
antonailog/forge-skills · _archive/2026-07-04-forge-deliver-retired/SKILL.md · 端到端交付纯编排层:调用 forge-* 子 skill 从需求一路编排到发布和文档,.deliver/state.json 检查点,支持 --auto /…
git:20260704.cb84167 · audit A · 13 stars
forge-bugfix SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-bugfix/SKILL.md · 系统性 Bug 修复流水线(P0-P8):一次修一个,强制根因分析、独立 worktree、TDD、双层验收报告、forge-qa 回归;多会话经 .forge/active.md…
git:20261010.1c72700 · audit A · 13 stars
forge-design-lab SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-design-lab/SKILL.md · 在真实 token、真实像素的 HTML 骨架上做页面与组件的设计决策:生成可点、可改、可存的设计工作台,按七层逐节点审查,保存即导出 token 与 CSS 并回写 DESIGN.md 的 token…
git:20261010.1c72700 · audit B · 13 stars
forge-design SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-design/SKILL.md · 全栈设计规划:分级门控管理 DESIGN.md 与 DESIGN-CHANGELOG,内置可检索设计规则库(UX 规则/配色/字体),三层 Token、forge-design-lab 工作台门禁(布局/比例/密度在真 token…
git:20261010.1c72700 · audit A · 13 stars
forge-eng SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-eng/SKILL.md · 工程实现主力:管理 ENGINEERING.md,完整/轻量两模式;worktree 会话隔离、分级 TDD、验证门(证据先于断言)、任务原子化 Wave 并行、独立…
git:20261010.1c72700 · audit A · 13 stars
forge-prd SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-prd/SKILL.md · 产品诊断与 PRD 迭代:诊断根因(设计缺陷/实现偏离/PRD 遗漏),必要时反驳需求,更新 PRD 并生成带异常态门禁的 Feature Spec。 触发方式:用户说"更新PRD"、"调整需求"、"迭代PRD"、"forge-prd"、描…
git:20261010.1c72700 · audit A · 13 stars
forge-review SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-review/SKILL.md · 上线前 PR 审查。分析当前分支与基础分支的 diff,检查 SQL 安全、竞态条件、 LLM 信任边界、枚举完整性等测试捕获不到的结构性问题。发现问题直接修复。 触发方式:用户说"review"、"审查代码"、"上线前检查"、"forge…
git:20261010.1c72700 · audit A · 13 stars
forge-ship SKILL.md skill
antonailog/forge-skills · _archive/snapshots/2026-10-10-feature-doc/forge-ship/SKILL.md · 发布上线:PR only(建 PR 即停)或 Full ship(合并 PR + 同步本地基础分支);测试失败不发布、不 force push,状态汇报严格区分提交/推送/合并/部署。 触发方式:用户说"ship"、"发布"、"合并上线"、…
git:20261010.1c72700 · audit A · 13 stars
DESIGN.md@docs DESIGN.md file
antonailog/forge-skills · docs/DESIGN.md
git:20260427.72938ed · audit A · 13 stars
forge-brainstorm SKILL.md skill
antonailog/forge-skills · skills/forge-brainstorm/SKILL.md · 通用头脑风暴:4 种模式(产品/内容/构建/探索)× 6 阶段,强制前提挑战和 2-3 方案,产出可跨会话续聊的思考文档;支持 Mermaid/图辅助判断。 触发方式:用户说"头脑风暴"、"brainstorm"、"讨论一下"、"我有个想法…
git:20260717.95d1b1c · audit A · 13 stars
forge-bugfix SKILL.md skill
antonailog/forge-skills · skills/forge-bugfix/SKILL.md · 系统性 Bug 修复流水线(P0-P8):一次修一个,强制根因分析、独立 worktree、TDD、双层验收报告、forge-qa 回归;多会话经 .forge/active.md…
git:20261010.1c72700 · audit A · 13 stars

Every file in antonailog/forge-skills

Other files named forge-doc-policy

forge-doc-policy SKILL.md skill
yike-gunshi/forge-skills · skills/forge-doc-policy/SKILL.md · 文档落地治理规范。统一管理 docs/ 目录下文档的写时约束、读时索引、生命周期标记。提供当前真相源白名单(doc-paths.md)+ frontmatter schema +…
git:20260717.95d1b1c · audit A · 13 stars

Browse by kind, by grade A, or by owner.