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

.github/目录规则

根README.md是唯一主页，本目录禁止新增README.md。原首页贡献者名单与鸣谢集中保存在.github/CONTRIBUTORS.md，不在根README重复维护。

三个资源域

目录	职责	入口
context/及同级平铺的Context资料、tool-explanation-template-v*.md	公开资料、规则、文档及数据；研究档案仅留已有本机副本	context/README.md、context/AGENTS.md
skills/	所有既有Skill指令和流程，统一治理	skills/README.md、skills/AGENTS.md
extensions/	固定上游源码、配置与仍保留的小工具	extensions/README.md、extensions/AGENTS.md

对象在各域平铺；资料集合和原生程序内部结构不拆散。旧docs/assets/metadata/prompts/research/scripts/tools不再作为并行活动根目录。

Context平铺文件

原ai-citation、metadata、prompts、getting-started目录中的文件已平铺到.github/根；无重名的文件保留原名，冲突的README.md、AGENTS.md仅加集合名区分。两个说明模板为.github/tool-explanation-template-v0.md与.github/tool-explanation-template-v1.md。导航见context/README.md。

文件组	用途	编辑前阅读
AI引用文件；指南为ai-citation-AGENTS.md	AI引用语料	ai-citation-AGENTS.md
metadata文件；指南为metadata-AGENTS.md	分类、术语与历史路径映射	metadata-AGENTS.md
提示词文件；指南为prompts-AGENTS.md	提示词入口	prompts-AGENTS.md
入门文件；指南为getting-started-AGENTS.md	新手入门与工作指南	getting-started-AGENTS.md

这些带集合名的指南保留分组规则，但不再是按目录自动发现的AGENTS.md；本文件负责路由，改动对应文件前须显式阅读。

维护脚本与共享库

校验、测试和资料维护脚本是仓库维护基础设施，不属于用户侧Extensions资源；直接平铺到.github/，不另建scripts目录或旧路径兼容壳。资料生成入口和研究抓取脚本现为sync-doc-toc.py、sync-faqi-catalog.py、sync-gongfa-catalog.py、fetch-research-raw.py；此前迁入根目录的Claude init_skill.py软链接现已退役，固定来源仍见FaQi历史档案。

类别	当前入口
Markdown校验	check-local-links.py、check-markdown-details.py、check-doc-structure.py
目录与导航	check-directory-docs.py、check-metadata.py、check-ai-citation.py
数据与来源	check-gongfa.py；本机研究副本另用check-research-raw.py、check-source-facts.py
Wiki	check-wiki.py；仍只校验明确给定的本地checkout
资料维护	sync-doc-toc.py、sync-faqi-catalog.py、sync-gongfa-catalog.py；fetch-research-raw.py会联网并写入本机研究资料，不属于默认测试
测试	test-gongfa.py、test-gongfa-catalog.py、test-faqi-catalog.py、test-local-links.py、test-markdown-details.py、test-source-archive.py、test-research-distribution.py
共享实现	source_boundaries.py、taxonomy.py、source_archive.py、book_views.py、tool_explanations.py直接平铺；供同级入口与原资料生成器共用，不保留lib包
依赖	requirements-gongfa.txt、requirements-faqi.txt

平铺共享模块

模块	职责
source_boundaries.py	原lib/__init__中的第三方、镜像与研究缓存边界；保留各检查器范围差异
taxonomy.py	读取原轻量YAML子集中的分类与文档导航
source_archive.py	严格读取JSON载荷，核对字节、模式、SHA、当前位置、当前绑定与隔离复原
book_views.py	复用既有链接规则及markdown-it-py，生成文集锚点、历史导航及目录，代码示例不改写
tool_explanations.py	绑定登记v1模板SHA，校验对象覆盖与18项顺序，安全渲染每对象独立三列表格

• 5个模块只保存一份，直接导入；不保留.github/lib/目录、软链接、__init__兼容包或新的运行框架。
• 公共函数小而稳定，历史来源/选区与当前实现绑定不能混同；不增加模型客户端或独立注册框架。
• 导入阶段不写文件、不联网、不执行目标程序；book_views只加载本仓链接检查器的规则函数。
• source_archive在显式调用时读取资料；explanations_v1与冻结的documents分层保存，模板版本和完整对象集合由tool_explanations校验；v0不作为活动或兼容载荷。export_documents只向调用方指定的新隔离目录复原，拒绝越界、软链接及敏感路径，不恢复旧运行目录。
• 复用标准库、原YAML子集、既有slug规则及markdown-it-py，不自研解析器；原字节、控制字符、读取预算、归属和并行变化保护不变。
• 修改后先运行相关协议及make test-source-archive；最终完整make test按根AGENTS执行，不因路径调整削弱断言。

研究档案不属于公开仓库；默认make test不运行本机研究事实检查，已有完整本机副本时可显式运行make test-local-research。test-research-distribution.py防止研究路径重新进入Git索引，并确认整目录被忽略。

3个sync与1个fetch入口现已平铺到.github/根维护层；保持原校验范围和断言，同步Makefile、真实ROOT、导入与隔离夹具；从其他cwd调用不能误判仓库根。 原3份Actions定义已从当前文件树移除，原始字节仍保留在Git历史中；迁移Python脚本不恢复自动CI。

平台入口

ISSUE_TEMPLATE/、CODEOWNERS、FUNDING.yml、PULL_REQUEST_TEMPLATE.md、SECURITY.md、WIKI.md、labeler.yml、lint_config.json保留现有位置；用户本次点名workflows，不扩改其他协作入口。

• workflows/已退役，不再作为平台例外；禁止重建目录、符号链接或兼容壳。原3个定义已从当前文件树移除，原始提交仍在Git历史中。
• 自动CI、Labeler和Welcome不再触发；本地校验、测试和资料维护由根Makefile调用.github/根入口，不把空远端检查当CI成功。
• CODEOWNERS仍由@tukuaiai、@tradecatlabs覆盖，仅迁移路径，不改变审批或豁免资格。
• Actions定义只在历史提交中保留，不复制或执行；恢复自动化须显式授权，不能只重建路径而忽略权限、输入及检查生产者。
• 审批Ruleset25244224的tradecatlabs豁免只用于其自己的PR；其他PR仍须有效批准。仅退役两套保护中已停用的markdown-lint/link-checker；签名、PR、线性历史及其它保护不变，不伪造审核。
• Issue/PR模板保持协作职责，长期规则写根AGENTS或资源域AGENTS，不塞入模板与CI。
• 当前固定来源使用Extensions下两个Gitlink；Skill Seekers与Claude官方Skills Gitlink及Claude初始化器均已退役，固定来源快照、SHA与初审仍保留在FaQi资料中；不得提交缓存、私有模板、真实会话、数据库或凭据。

验证

从仓库根运行相关make lint、make check-links、make check-directory-docs及受影响协议检查，最终完整测试以根AGENTS为准。