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

功法 JSON 核心

字多不看

• 功法总表展示品级、名称和更完整的解释；品级使用“天阶高级”等完整名称，不缩写。解释展开登记摘要/问题/机制及条件/限制/预期结果、候选原文与用途/理由、Solve机制/适用范围/前提/边界，不新增主张；完整来源以JSON为准；Excel完整视图保留全字段。
• registry.json是功法条目唯一可编辑数据源；entry_status区分已登记与待评候选，候选不等于正式登记。历史来源候选仍保存在不可变快照，不因快照存在自动入登记。
• 2026-10-07两批共登记79条：仓内来源62条（首批41条、续收21条）＋指定项目页面17条；两批初评分别覆盖58条与21条。拼好码于2026-10-11按用户指令由地阶中级暂定调整为天阶高级暂定，历史值与理由见文件末尾审计。
• 截至2026-10-14，3条备忘录与3条早期Solve候选素材均未写入登记JSON或生成总表；定向语义复核将P15暂列为能力/学习框架，确认Solve候选A为6来源跨域合成且暂不作为单一方法候选；B可保留为来源绑定的待审候选但未进入机器登记；C收窄为审计既有检索结果集的单一OperatorSpec候选，不包括检索构造或执行。B/C写入机器登记均需另行确认。同日另冻结机器学习来源包中的漂移检测、分布外检查和置信度升级3条OperatorSpec，仅供来源追溯与人工复核；首轮对照官方stable文档发现原引用对完整操作契约仅有相邻支持，来源版本、许可与效果未验证，不进入登记或总表。另冻结此前仅由本地全量导出定位的2条同名Solve记录，供与既有候选逐项比较，未决定合并或登记。详细范围与未决事项见候选方法整理稿及交叉核对。
• 2026-10-15续审P19“最小模型—迁移—边界回填”：有限类比研究支持关系结构映射及对推论结构支持、目标域事实和任务相关性的分别核验；不支持该完整操作序列的来源归属或软件工程效果。编辑稿已澄清映射与验证边界，候选仍源自仓内备忘录，未分配ID、未写登记/总表或赋级。快照见source-selected-candidate-minimal-model-transfer-boundaries-20261015.txt；本次不是556→410全量语义去重。
• 2026-10-15续审Solve计算机科学pack entries[0..4]：CS2023官方课程页与报告仅支持算法策略主题，不证明Agent泛化操作或效果。抽象是视角、问题分解是流程中间产物；归约和动态规划保留窄边界待审；分治与已登记方法重叠，不重复登记。未改registry或总表，有限快照见source-selected-computer-science-entries-0-to-4-20261015.txt，不代表556→410全量去重。
• 2026-10-15续审Solve计算机科学pack entries[5..9]：CS2023支持贪心、回溯、分支定界和算法复杂度课程主题，不支持Agent完整操作合同；NIST形式化方法词条仅支持广义定义。贪心需局部选择性质/近似界；回溯和分支定界需明确状态、撤销/剪枝正确性与预算；复杂度需分开渐近分析和token/latency/成本测量；形式化方法与已登记轻量形式化高度相关。未新增登记、候选或评级；快照见source-selected-computer-science-entries-5-to-9-20261015.txt，不代表556→410全量去重。
• 2026-10-15完成Solve计算机科学pack entries[10..15]有限复核：STRIPS支持动作前置条件/效果和目标模型，但不证明通用Agent执行；invariant/interface/dependency graph沿用已有历史候选，不复制或升级；memoization与缓存误用约束分开，derived搜索循环只作编辑草图。未改功法登记/候选/总表或评级；快照见source-selected-computer-science-entries-10-to-15-20261015.txt，不代表全量语义去重。
• 2026-10-15续审Solve算法pack entries[1..6]：MIT讲义支持有限的近似比、随机算法、DAG拓扑序及在线竞争分析命题；随机重启/尾部置信、通用图建模、运行时并行安全和Agent质量映射仍缺合同。区分MethodSpec、OperatorSpec、MentalModelSpec与derived组合，不新增登记/候选/评级；快照见source-selected-algorithms-entries-1-to-6-20261015.txt，不代表556→410全量语义去重。
• 2026-10-15续审Solve机器学习pack entries[0..4]：官方文档支持传统估计器的测试集隔离、k-fold验证和按训练样本数的学习曲线；Agent hidden eval、task-fold评测、reasoning/context/tool-call资源曲线及预算正则化映射仍属未验证跨域类比。与已有实验设计、性能测量等记录相邻，不新增登记、候选ID或评级。有限快照见source-selected-machine-learning-entries-0-to-4-20261015.txt，只覆盖五条，不代表556→410全量语义去重。
• 2026-10-15续审Solve机器学习pack entries[5..8]：官方文档支持传统模型的数据泄漏边界、超参数组合搜索/嵌套交叉验证、分类概率校准及单特征置换敏感度；Agent隐藏评测、配置搜索、confidence/escalation及上下文/工具输出扰动仍属未验证迁移。置换分数变化不等于因果效应，概率校准也不等于动作阈值。与实验设计、指标优化、置信度升级和因果特征消融相邻但不自动合并；不新增登记、候选ID或评级。有限快照见source-selected-machine-learning-entries-5-to-8-20261015.txt，仅覆盖四条，不代表556→410全量语义去重。
• 两批入库初评的原始分布为黄7、玄47、地25、天0；这是修订前历史记录，不代表当前分布，也不是效果实测。
• 另于2026-10-14冻结Solve机器学习包中的因果特征消融来源记录，供因果语义与来源支持复核；两条source_refs目前仅有相邻支持，消融结果不自动构成因果证据，不进入登记或总表。
• 同日冻结主动学习来源记录：与通用“信息价值”相关但不完全等同；成本敏感的VOI可成为主动学习的查询策略。原引用未支持完整标签选择循环，补充综述不属于原引用，需新来源修订。本轮不进入登记或总表、不赋级，详见有限选区快照。
• 同日冻结摊销分析来源记录：MIT讲义支持操作序列成本上界方法，CS2023将其列为KA Core；原CS2023引用URL失效，“平均代价”还须与统计平均区分。只供人工审查，不进入登记或总表、不赋级。
• 另冻结programming-principles-101 pack中5条近标题记录，与历史候选A017/A032/A071/A097/A099作有限语义对照；操作化表达不自动构成独立功法，pack原文与许可未独立核验，不进入登记或总表。
• 另对照该pack最前面的7条原则记录（2.1–2.7）与历史候选A004–A010；七条均高度重叠，Solve步骤属操作化增量，来源、独立身份与效果未验证，不进入登记或总表。
• 另冻结该pack 3.2–3.10中的8条记录（跳过已审的3.7），与历史A012–A016、A018–A020对照：简洁/KISS与重复最少化/DRY高度重叠；变化适应、影响局部化、对称性、声明式表达、变动率各自边界不同或相邻。来源和独立身份仍未核验，不进入登记或总表。
• 另冻结该pack的3.12–3.21九条操作化记录（跳过另行审阅的3.14）：单一引用点与DRY/重复最少化高度重叠，分治对应已登记条目；抽象、封装、打包和职责分离按边界区分，但来源及独立身份未核，不进入登记或总表。
• 另冻结该pack的3.23–3.27五条操作化记录：3.25效率性与已登记性能测量原则高度重叠；易变性、互操作性、可靠性、可测试性是相关设计准则的流程化表达，身份、来源和效果仍未核验，不进入登记或总表。
• 另冻结该pack的3.28、3.30–3.33五条记录：3.30简单性与已审3.3高度重叠；3.32对称原理与3.8对称性强重复；3.31存在编号/标题与定义偏移。其余记录与胶水原则、SLAP等相邻，暂不新增登记。
• 另冻结该pack的3.34–3.39五条记录：3.35清晰原理与历史候选定义有偏移；3.35/3.39同名但对象不同；3.36安全原理仍须独立风险审查，不因Solve步骤化而登记。
• 另冻结3.40–3.44五条：3.41分离原则与3.18高度重复；3.42简单原则与3.3、3.30形成重复簇；组合、规模控制及透明性分别与胶水、模块边界和故障可控方法相邻，不据此新增登记。
• 另冻结3.45–3.49五条：3.47最小意外原则与已登记条目重叠；健壮性、修复与失败控制相邻；表达性和沉默原则按知识表达、输出通道边界处理，不作为登记证据。
• 另冻结3.50–3.54五条：3.52与性能测量原则高度重叠；生成、经济核算、多样性和可扩展性分别保留机械派生、总成本、真实变体与已证实扩展轴边界，不新增登记。
• 另冻结3.56–3.60五条：3.57与高内聚/单一职责重叠；3.55 UNIX哲学是未映射的历史复合候选，不等于Solve记录或已定义方法。
• 另冻结3.61–3.64及4.1五条：软件杠杆（3.61）此前已在近标题快照对照；shell、非交互和过滤器方法保留安全边界；4.1内聚审计与高内聚条目重叠。本批只新增4条记录的直接对照。
• 另冻结4.2–4.6五条：耦合、可逆性、技术负债与已有登记重叠；正交性保留变化轴边界，代码坏味作为诊断信号，不作自动重构授权。
• 另冻结entries[72..76]五条：契约设计与现有不变式/接口契约重叠；童子军规则受任务范围约束；内部测试指真实内部使用，橡皮鸭叙述不是证据；布鲁克斯法则须按任务依赖与并行性评估。
• 另冻结entries[77..81]五条：康威定律作为组织/架构假设；破窗与熵增只作类比，不证明因果；80-10-10此前已审，本次不重复计数；约书亚树命名与概念工程/变量索引相邻。
• 另冻结entries[82..84]三条：第二系统此前已审；重新造轮与胶水原则重叠；牦牛剃毛保留为问题栈/停止条件候选，不能中止必要硬依赖。
• 另复核软件工程Solve pack entries[0..4]：架构权衡已在历史快照，设计理由与现有登记重叠；需求工程过宽，可追踪性需限定范围，验证与确认的精确定义仍待来源核对。仅冻结四条新字段投影，均不新增登记/评级；SWEBOK/NIST页面只支持主题范围，不证明精确步骤、许可或效果。详见有限快照。
• 续审软件工程Solve pack entries[5..9]：CS2023 Software Engineering Version Gamma（2023年8月）补充支持迭代/快速反馈、代码评审、配置管理与版本控制、按新需求识别待改区域，以及重构对既有用户影响最小的目标；这些是课程主题/学习目标，不证明完整操作、许可或效果。该Gamma PDF是补充来源，不等于Solve原ref:cs2023固定来源；前批快照保留原样，当前更新见后续批次快照。详见entries 5–9有限审阅。
• 另审软件工程Solve pack entries[10..15]：Gamma支持CI、组件边界/API原则及可靠性telemetry等主题，但不证明全部操作；风险驱动测试和事故复盘仍缺精确流程来源，接口隔离仍是待审候选，可观测性与可观测性设计需先判断身份/阶段关系。只冻结entries[10]、[11]、[13]、[15]投影，不新增登记/初评/评级；entries[12]、[14]沿用旧快照。详见有限审阅与来源补充。
• 另审软件工程Solve pack entry[16]：它是引用需求、追踪、增量开发、评审、配置管理和可观测性的derived组合；与已登记总体交付流程重心不同，但来源只有不可独立复核的conversation映射，且阶段合同、风险/验证证据、失败恢复仍不完整。不新增登记、初评或评级。详见entry 16有限对照。
• 另审编程Solve pack entries[0..4]：快反馈与既有总体流程/小步候选相邻，假设驱动调试与溯因排错高度重叠；二分调试是同ID历史候选，旧“优先候选”不是登记；Python 3.12.15文档只支持断点/单步等工具能力，不证明完整操作契约，Agent trace仍受来源和数据边界限制。仅限前五条，不新增登记、初评或评级；详见有限语义复核。
• 续审编程Solve pack entries[5..9]：性能剖析是既有性能测量方法内的工具操作；最小复现与模糊测试沿用历史候选意见；静态分析及并发检测缺少可独立复核的来源。本轮只冻结entries[5]、[8]、[9]投影，entries[6]、[7]不重复复制或升级；不新增登记、初评或评级。详见有限复核。
• 再续审编程Solve pack entries[10..14]：小变更和读—执行—观察—修改并入现有交付/反馈循环；性质测试、差分测试沿用历史候选意见；插桩与tracing作为观测链相邻阶段，来源和身份边界仍待补足。本轮仅冻结entries[10]、[11]、[14]投影，不新增登记、初评或评级。详见有限复核。
• 继续审编程Solve pack末三条entries[15..17]：依赖最小化与胶水/依赖审查相邻但来源未支持具体方法合同；资源预算/停止语义属于横切约束，仍缺运行时方法来源；派生调试循环组合此前已审条目，不因此自动产生新身份。本轮不新增登记或评级。详见有限复核。
• 首审问题求解方法论Solve pack entries[0..4]：任务定框并入问题界定闭环；问题空间与解空间边界相关但不相同；手段—目的和启发式搜索沿用历史候选意见；表征变换与Projection转换相邻。原文获取有限，不新增登记或评级。详见有限语义复核。
• 续审问题求解方法论Solve pack entries[5..8]：构造性见证与元认知监控沿用历史候选；回看评估作为检查阶段但未证明独立流程；派生通用循环不按固定顺序登记。Newell–Simon与Pólya来源不支持线性阶段解释，NIH/National Academies页面返回403；不新增候选、登记或评级。详见有限语义复核。
• 首审信息与知识科学Solve pack entries[0..3]：区分信息需求、检索式扩展、来源血缘与既有结果集评测；DCAT/PROV-DM/FAIR支持元数据与追溯结构，不等于来源权威或许可批准；TREC的检索Recall与回答引用支持度precision/recall不可混用。沿用候选C窄边界，不新增登记或评级。详见有限语义复核。
• 续审信息与知识科学Solve pack entries[4..5]：区分FAIR数据可复用原则与社会公平，NIST/DCAT不支持差别影响审计，NIH页面返回403；派生检索循环缺组合、反馈和停止合同，仅作编辑性草图。与前批合计覆盖该6条pack，但不代表556→410全量语义去重；不新增候选、登记或评级。详见有限语义复核。
• 该pack的85条编号/标题结构交叉表显示85/85唯一映射到HTML历史候选且去章节号后标题一致；这是字段交叉核对，不是语义去重、来源独立证明或登记输入。当前85条记录均有直接语义对照（含此前单独审阅的信息隐藏3.14；本批7.7此前已审），但记录数不代表85个独立概念，也不代表556→410全量去重。
• 完整可复用正文从统一功法文集进入；文集不等于独立功法记录。
• 本体主文解释类型与语义；等级是分组，不是类型继承。
• 来源声明、编者摘要与真实效果证据不同；缺失字段明确列在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快照（惰性文本）
├── source-selected-candidates-20261013.txt   # 3项备忘录与3项早期Solve候选的冻结选区及来源指纹
├── source-selected-candidates-20261014.txt   # 机器学习包3条OperatorSpec的有限评审选区，不进入总表
├── source-selected-machine-learning-entries-0-to-4-20261015.txt # 机器学习pack前五条有限来源与语义复核，不进入总表
├── source-selected-machine-learning-entries-5-to-8-20261015.txt # 机器学习pack后四条有限来源与语义复核，不进入总表
├── source-selected-candidate-causal-feature-ablation-20261014.txt # 因果特征消融来源记录的有限评审选区
├── source-selected-candidate-active-learning-20261014.txt # 主动学习来源记录的有限评审选区
├── source-selected-candidate-amortized-analysis-20261014.txt # 摊销分析来源记录的有限评审选区
├── source-selected-candidate-minimal-model-transfer-boundaries-20261015.txt # P19与类比研究的有限来源对照，不新增登记或效果证据
├── source-selected-computer-science-entries-0-to-4-20261015.txt # Solve计算机科学pack前五条有限语义与来源复核
├── source-selected-computer-science-entries-5-to-9-20261015.txt # Solve计算机科学pack entries[5..9]有限语义与来源复核
├── source-selected-computer-science-entries-10-to-15-20261015.txt # Solve计算机科学pack末六条有限语义与来源复核
├── source-selected-algorithms-entries-1-to-6-20261015.txt # Solve算法pack六条source/derived条目的有限语义与来源复核
├── source-selected-title-matches-20261014.txt # 两条同名命中来源的有限冻结选区
├── source-selected-near-title-matches-20261014.txt # 五条编程原则近标题命中的有限冻结选区
├── source-selected-principle-operations-20261014.txt # 七条编程原则操作化对照及完整Solve记录
├── source-selected-principle-operations-3-2-to-3-10-20261014.txt # 八条编程原则语义对照及完整Solve记录
├── source-selected-principle-operations-3-12-to-3-21-20261014.txt # 九条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-3-23-to-3-27-20261014.txt # 五条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-3-28-to-3-33-20261014.txt # 五条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-3-34-to-3-39-20261014.txt # 五条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-3-40-to-3-44-20261014.txt # 五条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-3-45-to-3-49-20261014.txt # 五条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-3-50-to-3-54-20261014.txt # 五条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-3-56-to-3-60-20261014.txt # 五条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-3-61-to-3-64-and-4-1-20261014.txt # 五条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-4-2-to-4-6-20261014.txt # 五条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-entries-72-to-76-20261014.txt # 五条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-entries-77-to-81-20261014.txt # 五条编程原则语义对照及Solve字段投影
├── source-selected-principle-operations-entries-82-to-84-20261014.txt # 三条编程原则语义对照及Solve字段投影
├── source-selected-problem-solving-methodology-entries-0-to-4-20261014.txt # 问题求解方法论pack前五条有限语义复核及来源摘录
├── source-selected-problem-solving-methodology-entries-5-to-8-20261014.txt # 问题求解方法论pack后四条有限语义复核及来源摘录
├── source-selected-information-knowledge-science-entries-0-to-3-20261014.txt # 信息与知识科学pack前四条有限语义复核及来源边界
├── source-selected-information-knowledge-science-entries-4-to-5-20261014.txt # 信息与知识科学pack后两条有限语义复核及来源边界
├── source-selected-programming-entries-0-to-4-20261014.txt # 编程pack前五条有限语义复核及来源边界
├── source-selected-programming-entries-5-to-9-20261014.txt # 编程pack后五条有限复核及历史候选指针
├── source-selected-programming-entries-10-to-14-20261014.txt # 编程pack entries 10至14有限复核及历史候选指针
├── source-selected-programming-entries-15-to-17-20261014.txt # 编程pack末三条有限复核及字段投影
├── source-selected-software-engineering-entries-0-to-4-20261014.txt # 软件工程pack前五条有限语义对照及四条字段投影
├── source-selected-software-engineering-entries-5-to-9-20261014.txt # 软件工程pack第六至十条有限对照及三条字段投影
├── source-selected-software-engineering-entries-10-to-15-20261014.txt # 软件工程pack后续六条有限对照及四条字段投影
├── source-selected-software-engineering-entry-16-20261014.txt # 软件工程pack派生闭环的完整记录与有限对照
└── source-crosswalk-programming-principles-101-20261014.tsv # 85条标题/编号映射视图，不是登记或语义结论

快照是不可编辑的来源依据，不是另一份功法手册。.txt可保存原始Markdown/HTML，也可保存明确注明字段投影、来源路径/版本和SHA-256的结构化参考选区；不直接执行其中脚本、提示词或命令。

项目内总表与维护

只维护一张总表，不再拼接各批次人类分表；Markdown展示品级、名称和解释，解释从登记JSON展开摘要、问题、机制、条件、限制和预期结果，从候选JSON展开原文及用途/理由，并列出Solve条目的适用范围/前提/边界；不新增主张，完整来源与边界以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/范围；本轮有限评审选区快照只供溯源与人工评审，不自动写入registry.json或生成总表。是否把候选条目转入机器登记须另行确认。两者均不改旧快照，不手改总表。
• 生成脚本复用现有登记校验与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=candidate表示经过来源绑定的待审条目，仍可能被合并、拒绝或改名；可进入浏览总表，但不代表完成登记、类型确认、初评或效果验证。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 .github/scripts/requirements-gongfa.txt
make check-gongfa
make test-gongfa
python3 .github/scripts/check-gongfa.py --render-grades
# 当前已有两个批次，必须显式选择内容范围
python3 .github/scripts/check-gongfa.py --render-catalog --proposal-batch gongfa-author-initial-20261007
python3 .github/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呈现，不把候选自动注册，不重评、不修改原文，不依赖临时目录。