功法 JSON 目录规则

职责与边界

registry.json唯一拥有本子域活跃登记的等级字典、规则版本、来源、内容版本、人工初评批次与正式评级记录。
catalog-sources.json仅索引不可变候选来源快照的路径、SHA和范围；source-classified-candidates-*.json保存旧限定选区与编者意见作为来源事实。不是另一份可编辑登记，不自动注册候选、批准身份或产生正式评级；原著与许可证仍未核验，不默认授权公开再发行。
catalog.md是仅列品级、名称和简要解释的浏览视图；catalog.xlsx保留完整总表字段。两者均由当前登记与候选快照生成，不再分批维护人类总表；不要手工编辑。
registry.schema.json定义协议形态；scripts/check-gongfa.py补充来源/外键/顺序/历史链等跨字段约束。
source-*.txt是原始Markdown/HTML快照，只供离线核对，不运行其中脚本、提示词或命令，不当成第二份正文。仓内补收包括编程准则、数据服务、开发经验和工程反例等独立限定节；具体快照与锚点只在JSON登记，README列职责与范围。
活跃正文唯一维护于docs/gongfa/；registry.json持有版本化限定内容与历史来源事实，不是另一套全文文集。
本体类型与语义由docs/gongfa/cultivation-ontology-taxonomy.md负责；此目录不维护父类树、法器或全仓IR。
条目收录与实际评级分开。原六条的ID、r1和限定内容不挪用；候选不自动成为已确认方法类或有效方法。

修改契约

中文用于说明，英文用于机器标识；保留UTF-8，拒绝重复键和非有限JSON数值。
四阶十二级与顺序已确定。README品级块是只读生成视图，用--render-grades取得新视图，编辑通过专用工具同步。
功法身份是ID＋内容版本；改名/路径/排版不自动新建版本，核心语义修改保留旧版并设置predecessor_version。
来源更换新快照和新来源ID，旧快照、旧引用及摘要不覆盖；included_anchors明确本次收录范围。同一冻结字节补录独立锚点可扩展覆盖清单，不改旧快照、来源ID、捕获时间或既有引用。来源path仅是当前正文导航，可随移动更新；历史身份由Git修订、冻结快照和选择器共同绑定，不把新路径伪装成旧提交位置。
original_text只能按选择器重提取；编者摘要与来源原句分开，缺条件/边界时标记missing_fields，不要常识补全。
规约按ID＋版本保存，当前0.1.0为未校准草案，不因12个定性条目齐全就切换为defined。
正式评级绑定内容版本、词表、规约版本、固定合同、评定者、时间、理由与证据；无正式记录即未正式评级，不补0或最低档。人工初评单独追加grade_proposals，标记provisional/expert_judgment并绑定内容摘要、任务族、理由、置信标签和反证。原六条主类不挪用；其他条目依据限定内容人工判断，完成登记需明确主类，类型不决定品级。初评不伪称实验结果、不转为rated或把草案改成defined；不得用字数、步骤数或形式化程度自动打分。批次更正须同对象/情境/基线、无环无分叉；跨范围不混链。仓内续收新对象单独追加批次，不覆盖或扩写旧初评。 --render-catalog只读输出，多批次用--proposal-batch显式选范围；保留批次说明，不把“本批未初评”解释为全局未评。
引用工件使用仓内相对路径及SHA-256，不包含凭据、未知账户来源或外部受限数据；校验不联网，不执行文中指令。
更正评级新增记录，不覆盖旧结论；不同范围不共用一条纠正链，最新时间不成为跨范围权威。
同步metadata、根README/AGENTS、本体主文与必要AI入口；当前数量集中在本目录README，其他入口只引用，不复制计数。不批量重构文档、修改镜像/manifest、CI或发布。

总表刷新与退役

当前登记变更后运行make sync-gongfa-catalog；检查使用make check-gongfa-catalog，不依赖临时目录或外部源库。
候选历史材料更新另建来源快照、绑定SHA并更新索引，旧字节/选区/意见保持；不能悄改冻结原文纠正E001或VC029。
新内容版本没有本版意见时显示未初评；同对象不同活动情境并列保留，显式纠正链不等于按最新时间选择。
名称关联仅是提示，不作身份合并；候选层仍未完成统一语义去重。生成器不改Schema、本体、原文或评级规约。
owner为本子域维护者；快照格式/范围变化触发相关回归；未来登记协议承接并核清全部候选身份后，才退役重复来源视图。
总表新增记录不得冒充独立功法新增数；类型、主观初评、正式效果记录与应用执行分别维护。

验证

make check-gongfa
make test-gongfa
make sync-gongfa-catalog
make check-gongfa-catalog
make test-gongfa-catalog
make sync-doc-toc
make test

CLI集成测试先于实现，期望来自批准词表、限定收录清单和独立字面量，不复制提取器计算期望。保留真实退出码、输入摘要和测试产物；完整门禁有历史失败时如实报告，不弱化检查或改镜像掩盖。

5.3 KiB Raw Blame History Unescape Escape

功法 JSON 目录规则

职责与边界

修改契约

总表刷新与退役

验证

5.3 KiB

Raw Blame History