vibe-coding-cn/.github/context/AGENTS.md

Context维护规则

职责与边界

• 公开仓库维护既有规则、文档、知识、数据及参考资料；对象在本域平铺，不把每条记录拆成目录。研究档案仅留在已有本机副本，不进入公开Git树。
• 入门、提示词、AI引用和metadata支持文件已平铺到.github/根；无重名文件保留原名，仅冲突的README和AGENTS指南分别以getting-started-、prompts-、ai-citation-、metadata-区分；本机research/副本保留具体对象事实。
• AI引用维护当前项目语料；metadata只做导航和术语，不另建本体或登记。通用附件和外部资源集合已从当前树退役；FaQi所需固定外部来源按历史路径保存在faqi/data.json的documents中，由法器生成器校验。
• 执行指令归../skills/，程序归../extensions/；不得把参考材料全部提升为系统指令。

工具说明模板

• 活动v1模板位于.github/tool-explanation-template-v1.md，历史v0模板同级保留为.github/tool-explanation-template-v0.md；FaQi与功法载荷仍按v1模板SHA和18项顺序校验。
• 不恢复assets/附件集合或模板子目录兼容壳。

功法与法器

• 两者各只有data.json维护源；生成器输出轻量README.md导航页及天、地、玄、黄四阶Markdown正文，不新增并行登记、旧目录兼容树或活动Excel。
• 当前data.json.explanations_v1是逐对象说明载荷，与冻结原文档documents分开；每项绑定v1模板SHA，必须按对象身份完整覆盖18个原名原序字段。未知内容在相应字段标待核并说明原因，不得复制评级理由冒充动机、推断设计或把待核内容写成已验证事实。第16–18项按图尔敏核心关系对应：结论为主张、依据列出可定位事实、连接规则明确说明证据凭什么支持主张，并受第15项条件/反例约束；仅列字段引用不算推理。来源存在、说明审阅和暂定赋级不得直接推导许可、效果或正式评级。v0仅保留为历史模板，不作为活动载荷或兼容格式。
• Extensions生成器从v1载荷生成README和四阶文档；有明确品级的对象进入对应阶，每个对象仍单独生成一张“序号／说明项／内容”三列表格。同品级记录按explanations_v1.items顺序展示；调整该顺序只改变浏览顺序，不改变身份、初评或正式评级。无明确品级的功法保留在黄阶文档的“暂不可判”附录并明确不归黄阶。README只提供分阶及原文档导航；原始文档仍在data.json。严禁手改生成视图、把解释写入来源归档或改动原身份、版本、来源和评级字段。
• 载荷documents以历史路径为身份。保存原字节、文件模式、SHA、ID、版本、选择器、来源修订、原分类、历史意见及排除项；不得全局改写历史路径。
• locations、live_sources、projections分别描述当前位置、当前实现摘要与现有引用；retired_submodules明确标出仍保留冻结原文和初审、但已从当前树移除的固定子模块。当前实现绑定不替代原SHA、固定来源、选区或原初审，不自动表示新实现已受审。
• 原始登记仍按载荷内Schema和检查器维护。修改原文后须更新其真实摘要；历史来源、人工初评和正式评级分开，不自动合并语义身份、恢复排除或赋级。2026-10-19按用户指令将来源快照中的331条记录逐条登记；用户曾确认该批次当时的说明正式通过审阅。此确认只对当时版本成立，后续修改不自动继承；条目当前状态须按实际修订记录标明。该确认不改写历史来源，也不推导书目/许可、实际效果或正式评级状态；新增条目仍须逐条登记。
• 当前413条均为登记对象，其中331条是上述来源迁入；总表413条，410条保留前瞻初评、3条保留“暂不可判”，正式评级与效果记录均为0。历史的80条既有登记与331条来源快照记录分布，以及79/410迁移基线只表示当时状态。用户新增Lambda演算并指定天级上品，对应tian-advanced；总表及首页学习入口将其列在拼好码之前，原始文档、原文文集与既有初评不变。
• 新增gongfa-input-state-transform-output-cross-domain独立登记，按用户要求暂拟天阶初级；gongfa-input-state-transform-separation另追加天阶中级暂定意见并保留玄阶历史批次；gongfa-state-classification身份与玄阶中级意见不变。三者主题相邻但身份及范围不合并；正式评级和效果记录仍为0。
• 新整理正文可以直接加入JSON载荷的逻辑文档，不重新创建旧物理目录。先提交首发正文，再以该真实Git修订及JSON载荷选区冻结来源；不能用一个尚不存在正文的基线冒充来源版本。
• 法器73个来源选区、10项来源限定实现、13条本地记录、9条排除、12项依赖对象、8类依赖、158条关联资源和30项重要性赋级各有分母，不能相加为独立产品数。
• 用户确认的说明审阅不替代原著/HTML来源核验、书目/许可、运行、效果与正式评级；这些状态各自维护，后续修订也不自动继承旧确认。

来源保护

• 已有本机副本中的三个research/vibe-*源事实镜像按research/facts/sources.yml核对文件数、内容摘要、隐私和非公开边界；不得批量格式化或纳入公开提交。
• 已有本机副本中research/*/raw/的原始API、README、来源清单与Git缓存保持原事实；历史puller路径是来源身份，不冒充当前活动命令。
• 固定外部Git仓库及研究缓存不执行、不抓取、不上传；私有模板、真实会话/数据库、凭据和个人资料不得纳入公开提交。

验证与维护

• 运行对应make sync-gongfa-catalog或make sync-faqi-catalog生成阅读视图；只读检查用make check-gongfa-catalog、make check-faqi-catalog。
• 公开资料变更运行相关协议、内链、索引与结构检查；已有本机研究副本可显式运行make test-local-research，该目标不属于默认make test，也不应要求新克隆具备研究档案。
• 最终完整make test绑定实际代码和工件，不冒称生产或效果验证。
• 根README.md仍是唯一主页；文集和Context入口只负责阅读导航，维护者规则写本文件或既有子域AGENTS.md。