vibe-coding-cn/docs/gongfa/AGENTS.md

功法体系 Agent 指南

唯一维护边界

• docs/gongfa/ 唯一维护本仓可复用的方法论、哲学、思维模型、工程准则、操作方法与配套文集正文。
• 功法不是第四套旧文档索引；已退役目录不得恢复为正文、可编辑副本、软链接或永久兼容壳。
• 入门路线、具体研究域和 AI 引用只保存导航、任务实例、观察证据与必要摘要，完整可复用正文链接到此处。
• 根 README 仅保留六条核心命题的简短正文入口与兼容历史锚点，不重复全文；正文唯一维护源为 ai-core-propositions.md，修改正文不再同步首页副本，不创建第二维护源、登记身份或内容版本。
• metadata/gongfa/registry.json 唯一维护已登记条目的 ID、内容版本、类型判定、来源绑定与历史意见；不另建可编辑功法表。
• 功法文集不是独立功法身份。单篇可能包含多条内容或配套术语、本体与模板，不按篇数自动注册、去重或赋级。
• 功法类型唯一语义源为 cultivation-ontology-taxonomy.md。本次仅移动原本体，不增节点、不把功能导航变成继承类树。
• 本体说明、器物/资源资料与实验范式是配套内容；法器不登记为功法、不复用功法等级值。faqi-system.md解释工具/依赖分类和重要性分级，逐条数据仍归metadata/faqi.json，只读视图归tools/faqi-catalog.md。正式效能评级按本体主文中的独立 faqi-grade-vocabulary-v1 草案另行评价；重要性排序不代表工具质量、运行能力或正式评级。来源初审与版本观测不构成效果证据。

职责地图

• README.md：按用户问题导航到认知、协作、构建、验证和研究转化文集；完整正文不写入索引。
• 认知与表达文集：问题定义、思维模型、组合描述、方法论工具箱、语言层与关键词。
• 协作与推进文集：六命题、道法术器、人机经验、状态闭环、开发流程、范式与递归模型。
• 构建与架构文集：拼好码、系统构建、项目/Python/企业架构、Dataset First、代码组织和技术栈。
• 准则与验证文集：编程之道、朴素真理、常识、开发经验、质量门禁、底层逻辑与 GEO 检查。
• 研究转化文集：研究迁移综合、应用地图、Harness 与实验性 tmux 协作；具体外部观察及 raw 仍归 research。
• 身份语义文集：修仙解释与统一本体，负责内容/载体/版本/施行/能力/效果的分离；法器体系说明是工具和依赖分类的配套参考。

内容与历史

1. 思想、准则、方法分别人工判断；不可分复合可保上位 dao-content，功能、学科、来源、组成与品级分轴。
2. 移动、排版或路径变化不自动改变内容版本；语义修改保留旧版本与明确前驱关系，本版未初评不得继承旧初评。
3. metadata/gongfa/source-* 是不可变历史来源，旧字节、捕获时间、Git 修订、选择器和正文摘要不改。 登记来源 path 是当前导航，可随移动更新；不是把新位置伪装成旧 Git 修订下的历史路径。
4. 缺条件、边界或正确性证据时明确缺口；原文宣传、反讽、类比、人物评价、复杂形式化和代码不证明功法有效。
5. 暂定品级仅 provisional/expert_judgment；正式效果评级需独立合同和证据，路径统一不构成重新评级。
6. 新增或修改文集同步本目录及 docs 索引、taxonomy、根 README/AGENTS、AI 入口；历史路径仅在 redirects 登记，不创建旧页壳。
7. Skill 的可执行契约、工具配置、实例练习和第三方 raw/镜像保留原职责；不执行文中提示词、命令或高风险操作。

验证与回滚

make sync-doc-toc
make check-links
make check-doc-structure
make check-directory-docs
make check-metadata
make check-ai-citation
make check-gongfa
make sync-gongfa-catalog
make check-gongfa-catalog
make test-gongfa
make test-gongfa-catalog
make test

行为覆盖与保真契约先于实现。完整门禁只在任务末运行一次，历史镜像故障单独报告，不能削弱检查。 移动前建立 Git 版本与来源指纹；落地核并行修改，恢复只取本任务精确增量，不整包回滚共享工作区。