gewuyou 66395739dc docs(governance): 收口公开文档治理口径
- 更新 AGENTS.md、DOCUMENTATION_STANDARDS.md 与 gframework-doc-refresh 规则,禁止在公开文档中暴露 inventory、覆盖基线与恢复点

- 修复 Core、Game、Ecs.Arch 与 abstractions 栏目中的 XML 覆盖表述,改为面向使用者的源码阅读入口

- 补充 contributor 页面 frontmatter,并统一 landing page、验证基线等内部术语为读者导向表达

- 更新 documentation-full-coverage-governance tracking 与 trace,记录 -batch-boot 75 基线、验证结果和下一步
2026-04-24 08:31:23 +08:00
..

GFramework Skills

公开入口目前包含 gframework-doc-refreshgframework-batch-boot

公开入口

gframework-doc-refresh

按源码模块驱动文档刷新,而不是按 guidetutorialapi 等类型拆入口。

适用场景:

  • 刷新某个模块的 landing page
  • 复核专题页是否与源码、测试、README 一致
  • 评估是否需要补 API reference 或教程
  • 在 adoption path 不清晰时引入 ai-libs/ 消费者接法作为补充证据

推荐调用:

/gframework-doc-refresh <module>

示例:

/gframework-doc-refresh Core
/gframework-doc-refresh Godot.SourceGenerators
/gframework-doc-refresh Cqrs

gframework-batch-boot

gframework-boot 的基础上,自动推进可分批执行的重复性任务,不需要人工一轮轮重新触发。

适用场景:

  • analyzer warning reduction
  • 大批量测试结构收口
  • 分模块文档刷新 wave
  • 任何有明确 stop condition 的多批次任务

推荐调用:

/gframework-batch-boot <task-or-stop-condition>

批处理阈值速记:

/gframework-batch-boot 75
/gframework-batch-boot 75 2000
  • 单个数字默认表示“当前分支全部提交相对远程 origin/main 接近多少个文件变更时停止”
  • 两个数字默认表示“当前分支全部提交相对远程 origin/main文件数 OR 变更行数”,顺序固定为 <files> <lines>
  • 不推荐写 /gframework-batch-boot 75 | 2000,因为 | 很像 shell pipe若用户这样写也应按 OR 语义理解并在后续说明中归一化成无 | 版本

示例:

/gframework-batch-boot 75
/gframework-batch-boot 75 2000
/gframework-batch-boot continue analyzer warning reduction until branch diff vs origin/main approaches 75 files
/gframework-batch-boot keep refactoring repetitive source-generator tests in bounded batches

共享资源

  • _shared/DOCUMENTATION_STANDARDS.md
    • 统一的文档规则、证据顺序与验证要求
  • _shared/module-map.json
    • 机器可读的模块映射表
  • _shared/module-config.sh
    • 轻量 shell 辅助函数

内部资源

gframework-doc-refresh/ 下包含:

  • references/
    • 模块选择、证据顺序、输出策略
  • templates/
    • landing page、专题页、API reference、教程模板
  • scripts/
    • 模块扫描与文档验证脚本

vitepress-* skills 不再作为并列公开入口保留。