# 功法 JSON 核心 ## 字多不看 - [功法总表](catalog.md)是品级与名称的浏览简表；[Excel完整视图](catalog.xlsx)保留详细字段，数量和覆盖由仓内生成器维护。 - [registry.json](registry.json)仍是活跃登记唯一可编辑数据源；候选历史材料是不可变来源快照，不自动入库。 - 2026-10-07的两次入库轮次共79条：仓内62条＋指定项目页面17条；另续收21条。拼好码于2026-10-11按用户指令由地阶中级暂定调整为天阶高级暂定，历史值与理由见文件末尾审计。 - 两批入库初评的原始分布为黄7、玄47、地25、天0；这是修订前历史记录，不代表当前分布，也不是效果实测。 - 完整可复用正文从[统一功法文集](../../docs/gongfa/README.md)进入；文集不等于独立功法记录。 - [本体主文](../../docs/gongfa/cultivation-ontology-taxonomy.md#功法本体与品级)解释类型与语义；等级是分组，不是类型继承。 - 来源声明、编者摘要与真实效果证据不同；缺失字段明确列在`missing_fields`，不编造成立条件或效果。 ## 文件与职责 ```text gongfa/ ├── README.md # 人类入口与只读词表视图 ├── AGENTS.md # 数据边界与更新约定 ├── registry.json # 唯一可编辑数据核心 ├── registry.schema.json # JSON Schema Draft 2020-12 ├── catalog.md # 全部功法总表的生成浏览视图 ├── catalog.xlsx # 同一总表的完整Excel视图 ├── catalog-sources.json # 候选历史快照路径、SHA与范围索引 ├── source-classified-candidates-20261007.json # 旧HTML、已审Solve与HTML续提的限定材料/旧意见 ├── source-thinking-models-81fc7ae.txt # 思维模型原始Markdown快照 ├── source-methodology-toolbox-81fc7ae.txt # 编号方法工具箱原始Markdown快照 ├── source-compositional-description-81fc7ae.txt # 组合描述模型原始Markdown快照 ├── source-glue-coding-81fc7ae.txt # 拼好码原始Markdown快照 ├── source-system-building-81fc7ae.txt # 三种系统构建方法原始Markdown快照 ├── source-problem-solving-81fc7ae.txt # 问题界定与求解体系原始Markdown快照 ├── source-recursive-self-optimizing-system-81fc7ae.txt # 递归自优化形式模型原始Markdown快照 ├── source-programming-dao-81fc7ae.txt # 编程之道限定准则与状态责任追踪快照 ├── source-software-engineering-truths-81fc7ae.txt # 朴素真理原始Markdown快照 ├── source-dataset-first-data-service-81fc7ae.txt # 数据服务结构原始Markdown快照 ├── source-development-experience-81fc7ae.txt # 开发经验原始Markdown快照 ├── source-quality-gates-and-pitfalls-81fc7ae.txt # 质量门禁与反例原始Markdown快照 └── source-methodology-931f79be.txt # 指定页面原始HTML快照（惰性文本） ``` 快照是不可编辑的来源依据，不是另一份功法手册。`.txt`避免把历史Markdown当作本仓正文重新解析链接，也不直接执行网页脚本。 ## 项目内总表与维护 只维护一张总表，不再拼接各批次人类分表；Markdown仅列品级和名称供浏览，详细字段以登记及候选JSON为准；Excel保留限定原文/源条目、选区、用途、边界、理由和反证。 总表每次读取当前登记，另消费此前已分类候选的仓内快照；不依赖原HTML目录、个人Excel、完整Solve或临时工作目录。 聚合记录数量以[自动生成摘要](catalog.md#字多不看)为准，不能当成已登记数或经语义去重的独立功法数。 ```bash make sync-gongfa-catalog make check-gongfa-catalog make test-gongfa-catalog ``` - 登记内容/意见更新仍写`registry.json`，再生成总表；现有协议和正式评级门槛不变。 - 来源候选的旧意见只是来源事实：此前四HTML、Solve仅已审首24和HTML续提。未审材料不混入。 - 候选变更另建冻结快照、更新`catalog-sources.json`的路径/SHA/范围；不要直接修改旧快照或表格。 - 生成脚本复用现有登记校验与[openpyxl](https://openpyxl.readthedocs.io/)，依赖最低/固定版本3.1.2。 - 默认只检查；`--write`只更新带生成标记的视图，不改原文或源意见，拒绝截断文字、公式解释、覆盖非生成文件和越界路径。 - 同名内容保留关联，不自动合并身份；新内容版本不继承旧品级，多情境活动意见不按最高档或最新时间裁决。 - E001灾备模型、VC029 CAP简述仍暂不可判；已知正确性/前提问题不以最低档遮盖，修订须另存限定内容与来源版本。 - 原著、许可证、独立语义批准和效果尚未核验；此次仅本地维护，没有提交、推送或发布授权。 本页后续的来源、续收和两批初评说明记录既有入库轮次，不代替总表的全部来源范围。 ## 数据结构 | 区域 | 内容 | 版本与边界 | |---|---|---| | `schema_version` | JSON协议版本，当前`1.1.0` | 新增人工初评，不代表评级规约已校准 | | `vocabulary` | 四阶十二级的稳定值与数组顺序 | `gongfa-grade-vocabulary-v1`；名称、顺序不代表倍率 | | `policies` | 版本化判级规约 | 当前`gongfa-grading-policy@0.1.0`，状态`draft` | | `sources` | 原路径/URL、来源修订、原始快照、摘要、明确收录范围 | 网页无Git提交，不伪造；仓内来源固定到提交 | | `gongfa` | ID、内容版本、限定原文、摘要、来源选择器和人工判定主类指针 | 完整身份是`id@content_version`；同ID可以保留多版 | | `grade_proposals` | 人工初评批次、内容摘要、分类/评级理由、任务族、置信标签与反证 | 显式批次保存暂定建议及历史；不当成实验结果，不写入正式评级 | | `assessments` | 对象版本、规约版本、条件、证据、评定者、时间与纠正历史 | 当前为空，尚无正式效果评级；不内嵌永久等级 | `ontology_type`保留原六条主类，并按限定内容为其余条目明确主类；未来尚未分析的候选可为`null`。 本协议只接受三条基础内容类及复合内容的`dao-content`指针，不接受软件类、等级或新造类；未来细类引用需显式扩展协议。 `entry_status=registered`表示已完成条目登记，不表示已验证效果、完成评级或独立语义审查。 ### 内容与摘要 - `original_text`＋`text_sha256`：按来源选择器提取的限定原文，而非整篇文章。 - `profile.provenance=editorial_summary`：编者摘要/原句选择，说明问题、机制、适用条件、边界、预期结果及核心问题。 - `claim_status=source_statement`：记录来源如此表述，不把其主张当成独立实验证明。 - `missing_fields`：未提供的语义字段。空数组表示此条没有提取到说明，不表示没有条件或风险。 - 纯解释内容可以没有步骤或产物；原文中的工具建议不成为唯一依赖或账号授权。 ### 来源与提取范围 仓内十二份来源固定于提交`81fc7ae599da7b7b0ce02ea0b069a2c88d288a4e`，另保留一份指定页面来源。 仓内条目覆盖思维模型、工具箱、胶水原则、系统构建、问题求解、编程准则、数据服务及工程反例等限定内容。 组合描述的转发节、重复出现的分而治之和单一职责等表述不另凑条目；未声称穷尽全仓。 当前数量与来源范围集中在本入口，其他导航不复制易漂移的计数；登记详情以JSON为准。 奥卡姆简化准则与工具箱操作版保留为不同限定内容，不凭同名合并；网页拼好码与胶水原则也不自动视为同一版本。 指定页面：。 读取时间：2026-10-07T04:17:07.958661Z；HTML摘要：`931f79be42fee9c17a2765214977b5c30311fbbd0ab983f510fefff784705de2`。 只取17个方法标题下带`#vibecoding方法论`标记的段落，排除最后的公开来源说明；页面“唯一根”不成为类型父节点或高品依据。 此前内容完善轮于2026-10-07重新读取页面，HTML与旧快照逐字节一致；本轮只续收仓内内容，未重新抓取网站。 提取规则：HTML只统一显示空白；Markdown移除定位标题、首尾空白及末尾分隔线，保留正文Markdown。 `markdown-first-paragraph`跳过开篇引用说明；`markdown-prefix`按显式`stop_before`限定准则范围；其余取完整限定节。 当前文件修改不覆盖历史快照；检查不联网，不要求当前导航文件仍与历史快照逐字相同。 同一冻结文件补录新锚点时，扩展其`included_anchors`，不改变旧字节、来源ID或捕获时间；来源字节更新必须另存新快照。 ## 仓内续收与范围 本轮新增条目分别覆盖： | 来源 | 独立收录内容 | |---|---| | 编程之道 | 高内聚、低耦合、稳定接口、显式依赖、不变式、可推理性、最小惊讶 | | 软件工程的朴素真理 | 真实使用验证抽象、技术债登记、性能测量、故障可控、设计理由文档 | | Dataset First | 稳定数据集组织准则、新建数据服务作业流、外部源码数据集化接入 | | 开发经验 | 变量名索引、输入输出/状态变换分离、共享资源并发约束、DRY复用 | | 质量门禁与常见坑 | 输入规模与复杂度约束、缓存生命周期与隔离约束 | 每个内容有独立ID、限定锚点、`r1`、冻结来源和人工判断；结构准则不伪装成已执行的方法。 Dataset First 范式只取目录模板之前的规则和适用边界，不吞并另行收录的构建、接入流程。 高内聚与低耦合分别约束模块内部关系和模块之间依赖，不把同一原则的多处转述重复登记。 DRY与真实使用验证抽象分别保存限定原文，不借另一条的例外替本条补齐边界；来源中的绝对表述不成为普适保证。 来源中的操作、推送或测试顺序要求仅作为内容保存，不成为本轮执行授权，也不覆盖本项目测试先行等规则。 ### 前轮补收与摘要完善 | 内容 | 来源与范围 | |---|---| | 自顶向下系统设计 | 系统构建第一节；保留需求稳定性和返工风险 | | 自底向上系统构建 | 系统构建第二节；保留整体目标与组件无法集成的风险 | | 分而治之 | 系统构建第三节；保留拆分边界、接口与集成约束 | | 问题界定与求解闭环 | 问题求解“5.搭建体系”；不收新手提示词或后续应用例子 | | 方法论总体作业流 | 工具箱六步总体流程；不替代23个独立方法 | | 控制论与科学方法论 | 工具箱完整限定节；源文概括不是普适控制/收敛定理 | | 递归生成器自优化 | 递归自优化完整形式模型及附录；不动点表示不是实测改进 | | 规约先于实现 | 编程之道三条准则；不强编条件、风险或产物 | | 状态时间与责任追踪 | 编程之道“10.时间视角”；不重定义BFO实体或过程 | 前轮完善保留当时已有条目的ID、`r1`、限定原文、来源选择器与确认主类，只修订编者摘要：补明示核心问题与适用情境，拆开条件和失效边界。 当时九个新增候选随后已完成分类和初评，不与相似网页内容自动合并；本轮不再改动这批内容或旧摘要。 持续只依据本条限定原文，不借整篇文章的其他段落补字段；适用情境不表示充分的效果保证，未知继续留空。 ## 分类与人工初评 既有两批入库主类：解释型5、准则型20、方法型45、复合型9。复合型引用既有`dao-content`，不是另造第四条父树。 解释型讲关系，准则型规定取舍，方法型规定怎么做；完整内容同时承担多种功能时保留复合主类。 例如胶水原则是准则型，网页拼好码是复合型，不能凭相似名称合并。 初评分批追加，原批次及意见不覆盖： | 批次 | 内容范围 | 初评性质 | |---|---|---| | `gongfa-author-initial-20261007` | 原58条仓内与页面内容 | 人工初评，完整保持 | | `gongfa-author-repo-expansion-20261007` | 本轮21条仓内续收内容 | 新增独立意见，不纠正或取代旧范围 | 两批均引用现有规约`0.1.0`的方向作前瞻判断： 黄阶预计限定任务达标，玄阶预计相对合理基线有增益，地阶预计困难/迁移任务仍有用，天阶须预计能突破明确能力缺口。 初/中/高是本阶预计结果带，不是置信度、验证次数或等距倍率；仍待校准，不作跨任务总排名。 没有为了填满词表而判天阶，也没有把缺测自动补成黄阶。 每条初评记录绑定`id@content_version`和限定内容摘要，保存`task_family`、`classification_reason`、`reason`、`confidence`与`falsifier`。 这些是编者判断，不改写原文或`profile`，不宣称已有增益、收敛、胜率或独立评审。 `confidence`只是主观把握标签，不是准确率；`falsifier`是可推翻建议的条件，不是已经执行的失败记录。 共同应用前提、合理基线假设、作者与时间存于批次；基线已采用同一方法时不能预定额外收益。 更正初评追加批次并设置`supersedes`；同一纠正链须保留对象集合、应用情境与基线假设，且无环/无分叉。 不同对象集合或任务范围独立保存；多批次输出表格必须显式选批次，不能把最新时间当全局权威。 输出携带批次ID；“本批未初评”只表示所选批次没有该对象意见，不表示其他批次也未评。 内容新版本不自动继承初评；真正取得受控效果证据后，正式评级另记`assessments`。 ## 品级只读视图 由`vocabulary`生成。不要手工修改；检查器会拒绝与JSON不一致的视图。 重建入口不要求旧视图已正确，但仍检查JSON与来源；同步新视图后重新运行默认检查。 | 值标识 | 名称 | 大阶 | 细级 | 次序 | |---|---|---|---|---| | `huang-initial` | 黄阶初级 | 黄阶 | 初级 | 1 | | `huang-intermediate` | 黄阶中级 | 黄阶 | 中级 | 2 | | `huang-advanced` | 黄阶高级 | 黄阶 | 高级 | 3 | | `xuan-initial` | 玄阶初级 | 玄阶 | 初级 | 4 | | `xuan-intermediate` | 玄阶中级 | 玄阶 | 中级 | 5 | | `xuan-advanced` | 玄阶高级 | 玄阶 | 高级 | 6 | | `di-initial` | 地阶初级 | 地阶 | 初级 | 7 | | `di-intermediate` | 地阶中级 | 地阶 | 中级 | 8 | | `di-advanced` | 地阶高级 | 地阶 | 高级 | 9 | | `tian-initial` | 天阶初级 | 天阶 | 初级 | 10 | | `tian-intermediate` | 天阶中级 | 天阶 | 中级 | 11 | | `tian-advanced` | 天阶高级 | 天阶 | 高级 | 12 | ## 规则与评级 当前方向仍是提案：黄阶限定任务达标；玄阶对固定基线稳定增益；地阶在困难/迁移任务中达标；天阶突破事先记录的基线能力缺口。 每阶初/中/高对应预先校准的结果带，不能以验证次数、篇幅、复杂度、名气或宏观层次替代结果。 这里的不同任务集必须先固定；不构成跨任务、跨类型的永久总分。 `evaluation_contract=null`且`unresolved`非空，因此当前不能登记`rated`。 未来定稿须固定任务集、基线、环境/预算/应用方式、判级准则工件，均以仓内路径＋SHA-256引用；这比自由文本条件可重复核验。 评级`scope`须与该规约合同对应，效果证据另存于`evidence_refs`，不能仅引用介绍页或把文件存在当成效果成立。 - `unrated`：尚未评定，`grade_id=null`；可不额外创建一条空评级记录。 - `undetermined`：尝试过但不能判定，`grade_id=null`，保留原因及取得的证据。 - `rated`：等级是12值之一，须有已定稿规约、固定条件和至少一个可核验的证据工件。 更正追加记录并设置`supersedes`；同一纠正链必须针对同内容版本、同适用范围且无环/无分叉。 不同任务或条件应有独立结论，不以最新时间自动裁决全局等级；新内容版本不继承旧评级。 `defined`是数据中的规约声明，不是机器替人批准标准，也不证明所引用工件具有有效业务语义。 ## 运行与验证 功法检查单独需要Python3.10+，其余脚本的最低版本不变；安装命令在已有Python虚拟环境中运行。 依赖固定版本见[requirements-gongfa.txt](../../scripts/requirements-gongfa.txt)。 ```bash python3 -m pip install -r scripts/requirements-gongfa.txt make check-gongfa make test-gongfa python3 scripts/check-gongfa.py --render-grades # 当前已有两个批次，必须显式选择内容范围 python3 scripts/check-gongfa.py --render-catalog --proposal-batch gongfa-author-initial-20261007 python3 scripts/check-gongfa.py --render-catalog --proposal-batch gongfa-author-repo-expansion-20261007 ``` `--render-catalog`只从JSON输出ID、名称、分类和暂定品级，不改文件、不自动判级；理由在JSON中。 检查汇总的`proposed_grades`是初评记录数（含历史），不是正式评级数。 检查器：Schema、十二级、ID/版本、冻结来源/原文、覆盖、初评/正式评级外键与历史链、条件绑定及证据摘要。 测试产物保留在临时目录，输出路径写入日志；可用`--artifacts /tmp/新的目录`指定保留位置，目录已存在时拒绝覆盖。 相关测试只验证数据消费协议，不进行真实功法评级；Schema、CLI测试和作者核对都不等于方法效果证明。 登记检查、总表检查与相关测试纳入本地`make test`；未修改GitHub Actions选定目标，不宣称新增远端覆盖。 ## 变更记录 2026-10-07：将原六条登记与限定词表接入JSON核心，新增43条候选和五份来源快照；保存12条定性规则草案，无实际评级。 2026-10-07：补收九个仓内候选与四份来源快照，合计58条；人工完善旧摘要，分开条件与失效边界。协议、主类树、原文及评级状态不变。 2026-10-07：按用户要求完成全部条目的分类与人工初评，协议升为1.1.0；保留原六条主类、全部身份与原文，新增初评批次。正式规约和效果评级状态不变。 2026-10-07：继续从仓内补收21条、增加四份固定修订快照；原58条及旧初评完整保持，新增独立初评批次。 多批次继续显式选择，表格增加范围说明，未包含对象显示“本批未初评”；不改Schema、词表、正式规约或本体树。 2026-10-08：将此前全部已分类内容的总表移入项目，保留当前登记与三批候选来源的旧意见；新增离线生成/检查和行为测试。 同一总表提供Markdown及Excel呈现，不把候选自动注册，不重评、不修改原文，不依赖临时目录。