vibe-coding-cn/metadata/gongfa/README.md

功法 JSON 核心

字多不看

• 功法总表是品级与名称的浏览简表；Excel完整视图保留详细字段，数量和覆盖由仓内生成器维护。
• registry.json仍是活跃登记唯一可编辑数据源；候选历史材料是不可变来源快照，不自动入库。
• 2026-10-07的两次入库轮次共79条：仓内62条＋指定项目页面17条；另续收21条。拼好码于2026-10-11按用户指令由地阶中级暂定调整为天阶高级暂定，历史值与理由见文件末尾审计。
• 两批入库初评的原始分布为黄7、玄47、地25、天0；这是修订前历史记录，不代表当前分布，也不是效果实测。
• 完整可复用正文从统一功法文集进入；文集不等于独立功法记录。
• 本体主文解释类型与语义；等级是分组，不是类型继承。
• 来源声明、编者摘要与真实效果证据不同；缺失字段明确列在missing_fields，不编造成立条件或效果。

文件与职责

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或临时工作目录。 聚合记录数量以自动生成摘要为准，不能当成已登记数或经语义去重的独立功法数。

make sync-gongfa-catalog
make check-gongfa-catalog
make test-gongfa-catalog

• 登记内容/意见更新仍写registry.json，再生成总表；现有协议和正式评级门槛不变。
• 来源候选的旧意见只是来源事实：此前四HTML、Solve仅已审首24和HTML续提。未审材料不混入。
• 候选变更另建冻结快照、更新catalog-sources.json的路径/SHA/范围；不要直接修改旧快照或表格。
• 生成脚本复用现有登记校验与openpyxl，依赖最低/固定版本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为准。 奥卡姆简化准则与工具箱操作版保留为不同限定内容，不凭同名合并；网页拼好码与胶水原则也不自动视为同一版本。

指定页面：https://tradecatlabs.com/portfolio/02-vibe-coding-cn/。 读取时间：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。

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呈现，不把候选自动注册，不重评、不修改原文，不依赖临时目录。