vibe-coding-cn/.github/taxonomy.yml

sections:
  context:
    path: .github/context
    purpose: 公开规则、知识、文档、数据与参考资料，按需读取；研究档案仅保留本机副本
    entry: .github/context/README.md
    agent_guide: .github/context/AGENTS.md
  skills:
    path: .github/skills
    purpose: 全部既有Skill指令与流程，统一治理并引用单一代码源
    entry: .github/skills/README.md
    agent_guide: .github/skills/AGENTS.md
  extensions:
    path: .github/extensions
    purpose: 既有程序、小工具、独立脚本、检查器与适配器
    entry: .github/extensions/README.md
    agent_guide: .github/extensions/AGENTS.md
reading_paths:
  beginner:
    title: 新手路径
    documents:
    - .github/getting-started-README.md
    - .github/context/gongfa/README.md#doc-vibe-coding-experience
    - .github/pi-cli-setup.md
    - .github/how-to-complete-work.md
    - .github/context/gongfa/README.md#doc-problem-solving
    - .github/context/gongfa/README.md#doc-vibe-coding-state-transition
    - .github/context/gongfa/README.md#doc-glue-coding
    - .github/context/gongfa/README.md#doc-project-architecture-template
    - .github/context/gongfa/README.md#doc-quality-gates-and-pitfalls
  developer:
    title: 开发者路径
    documents:
    - .github/context/gongfa/README.md#doc-glue-coding
    - .github/context/gongfa/README.md#doc-vibe-coding-state-transition
    - .github/context/gongfa/README.md#doc-vibe-coding-cultivation-model
    - .github/context/gongfa/README.md#doc-keyword-system
    - .github/context/gongfa/README.md#doc-system-building
    - .github/context/gongfa/README.md#doc-technology-stack
    - .github/context/gongfa/README.md#doc-project-architecture-template
    - .github/context/gongfa/README.md#doc-quality-gates-and-pitfalls
  thinking:
    title: 思维模型路径
    documents:
    - .github/context/gongfa/README.md#doc-thinking-models
    - .github/context/gongfa/README.md#doc-compositional-description-model
    - .github/context/gongfa/README.md#doc-programming-dao
    - .github/context/gongfa/README.md#doc-software-engineering-truths
    - .github/context/gongfa/README.md#doc-recursive-self-optimizing-system
  agent:
    title: AI Agent 读取路径
    documents:
    - AGENTS.md
    - .github/context/AGENTS.md
    - .github/context/gongfa/README.md#doc-development-process
    - .github/getting-started-README.md
    - .github/context/gongfa/README.md#doc-vibe-coding-experience
    - .github/how-to-complete-work.md
    - .github/context/gongfa/README.md#doc-project-architecture-template
    - .github/context/gongfa/README.md#doc-quality-gates-and-pitfalls
    - .github/ai-citation-README.md
  faqi:
    title: 法器体系阅读路径
    documents:
    - .github/context/faqi/README.md#doc-faqi-system
    - .github/context/gongfa/README.md#doc-cultivation-ontology-taxonomy
selection_rules:
  faqi: 需要理解 Vibe Coding 工具/依赖分类、重要性分级或效能边界时，读法器体系说明，再核生成总表与登记事实。
  gongfa: 需要认知模型、问题求解、工程准则、架构模板、方法、流程、门禁或研究转化时统一读取；文集与独立功法记录分开。
  getting-started: 需要准备 Pi CLI、连接所选模型并验证本机工具调用时读取；《如何完成工作》是独立可选指南，通用经验链接到功法。
documents:
  getting-started:
  - path: .github/pi-cli-setup.md
    title: Pi CLI 安装与配置指南
    role: 可全文复制给网页版 Chat AI，逐步引导检查或安装 Pi CLI、连接 OpenAI GPT，并由用户在本机验证 Bash 工具调用；区分 CLI 可用、模型回答、工具执行和具体工作完成，验收后停止
  - path: .github/how-to-complete-work.md
    title: 如何完成工作
    role: 可选工作指南：围绕自选目标按需选择方法，实施或观察并以证据验收；不预设具体任务或固定流程
  gongfa:
  - path: .github/context/gongfa/README.md#doc-cultivation-ontology-taxonomy
    title: 修仙领域统一本体与分类设计（V4 BFO 草案）
    role: 固定 BFO 主干、唯一分类树、领域稳定 ID、实体/品质及规约/方法/过程细分类、制备、观测及再生证据链、分层身份与组成判据；功法收录/内容版本及四阶十二级接入JSON核心，限定内容可追溯、已有人工分类/初评、规约未校准且无正式效果评级，当前收录范围见子域入口；不扩展全仓本体
  - path: .github/context/gongfa/README.md#doc-problem-solving
    title: 问题求解
    role: 目标、现状、差距、标准、约束、对象与路径
  - path: .github/context/gongfa/README.md#doc-thinking-models
    title: 思维模型
    role: 第一性原理、奥卡姆剃刀、多阶思维、状态空间等认知工具
  - path: .github/context/faqi/README.md#doc-faqi-system
    title: 法器体系说明
    role: 工具与依赖分类边界、Vibe Coding重要性分级、选用方式及正式效能评级边界
  - path: .github/context/gongfa/README.md#doc-compositional-description-model
    title: 组合描述模型
    role: 对象、状态、快照、序列、过程、变换、同一/差异与关系
  - path: .github/context/gongfa/README.md#doc-ai-core-propositions
    title: AI 协作的六条核心命题
    role: 目标闭环、生成域、模型演化、隔离审查与能力编排
  - path: .github/context/gongfa/README.md#doc-dao-fa-shu-qi
    title: 道法术器
    role: 人机协作、抽象方法、工程流程与工具承载
  - path: .github/context/gongfa/README.md#doc-vibe-coding-experience
    title: Vibe Coding 经验
    role: 通用语言能力、人机分工、机器门禁和入门铁律
  - path: .github/context/gongfa/README.md#doc-vibe-coding-state-transition
    title: Vibe Coding 状态转移闭环
    role: 用固定目标、可变策略、分层反馈和验收集合统一理解 Vibe Coding
  - path: .github/context/gongfa/README.md#doc-development-process
    title: 开发流程
    role: 默认任务推进顺序、质量门禁和交付闭环
  - path: .github/context/gongfa/README.md#doc-methodology-toolbox
    title: 方法论工具箱
    role: 现象学还原、正反合、可证伪主义、形式化方法等提效工具
  - path: .github/context/gongfa/README.md#doc-glue-coding
    title: 拼好码
    role: 复用成熟能力、胶水原则、能力编排与业务交付
  - path: .github/context/gongfa/README.md#doc-lambda-calculus
    title: Lambda 演算
    role: 天级上品；变量绑定、函数抽象、归约与组合及工程语义边界
  - path: .github/context/gongfa/README.md#doc-system-building
    title: 系统构建方法
    role: 自顶向下、自底向上与分而治之
  - path: .github/context/gongfa/README.md#doc-project-architecture-template
    title: 项目架构模板
    role: 常见项目结构、架构设计原则、最低门禁和检查清单
  - path: .github/context/gongfa/README.md#doc-quality-gates-and-pitfalls
    title: AI 编程质量门禁与常见坑
    role: 系统提示词、强前置条件、常见坑和硬门禁
  - path: .github/context/gongfa/README.md#doc-software-engineering-truths
    title: 软件工程的朴素真理
    role: 代码、复杂度、需求、维护、质量、架构和团队的工程常识
  - path: .github/context/gongfa/README.md#doc-low-level-program-logic
    title: 底层程序逻辑设计与工程优化项
    role: 运行模型、并发模型、数据模型、性能模型和工程交付检查清单
  - path: .github/context/gongfa/README.md#doc-research-transfer-synthesis
    title: 研究迁移综合
    role: 对标拆解、改良迭代、杂交创新与可验证行动
  - path: .github/context/gongfa/README.md#doc-research-value-application-map
    title: 研究价值与应用地图
    role: 研究价值、核心启示、应用与转化路线
  - path: .github/context/gongfa/README.md#doc-harness-engineering
    title: Harness 工程解析
    role: 工程控制、评估器、反馈闭环与可靠性判断
  - path: .github/context/gongfa/README.md#doc-vibe-coding-cultivation-model
    title: 修仙解释图层
    role: BFO 下层展开的通俗解释；区分模型、会话、方法、工具、资源与任务评价
  - path: .github/context/gongfa/README.md#doc-language-layers
    title: 语言层要素
    role: 代码理解所需语言层级
  - path: .github/context/gongfa/README.md#doc-keyword-system
    title: 关键词系统
    role: Vibe Coding 与工程协作中的高频关键词
  - path: .github/context/gongfa/README.md#doc-experience-principles
    title: AI 编程经验准则
    role: 原首页经验的完整正文
  - path: .github/context/gongfa/README.md#doc-development-paradigms
    title: 开发范式演进
    role: 软件工程组织方式演进
  - path: .github/context/gongfa/README.md#doc-recursive-self-optimizing-system
    title: 递归自优化系统
    role: 递归自优化生成系统的形式化模型
  - path: .github/context/gongfa/README.md#doc-tmux-ai-swarm
    title: tmux 蜂群协作
    role: 实验性多终端协作范式；不是当前执行授权
  - path: .github/context/gongfa/README.md#doc-python-project-skeleton
    title: 通用 Python 项目骨架
    role: Python 应用、服务、脚本工具和库项目的通用骨架
  - path: .github/context/gongfa/README.md#doc-enterprise-architecture-template
    title: 企业级 Monorepo / Multi-repo 架构模板
    role: 中大型工程组织、平台工程和多产品线参考模型
  - path: .github/context/gongfa/README.md#doc-modern-enterprise-architecture-template
    title: 现代企业数字化平台架构
    role: 面向领域产品网络、微服务容器 GitOps 边界、AI 原生能力、微调治理、AI 事件响应、内部平台、数据产品、供应链安全、FinOps 成本治理、版本治理、版本控制面、基线版本策略、发布通道、兼容性与冻结控制总账、基线生产变更、发布编排、变更冲突与失败恢复总账、基线事故、问题、纠正行动与复发防止总账、基线数据产品质量、契约违约、运行血缘与可观测性总账、基线工程质量、测试证据、缺陷与发布验证总账、基线人员能力、培训、职责履职与职责分离总账、基线业务结果、价值实现与组合收益总账、基线价值流、关键旅程与端到端流程总账、基线架构视图、运行拓扑与依赖影响总账、基线质量属性、架构驱动与权衡决策总账、基线架构原则、约束、反模式与例外执行总账、基线安全配置、加固姿态与配置漂移修复总账、基线漏洞、暴露面与修复验证总账、基线威胁建模、攻击面与安全风险总账、基线容量、性能、弹性伸缩与成本效率总账、基线服务可靠性、SLO、错误预算与可观测性总账、基线备份、恢复、灾备与可恢复性验证总账、基线密码材料、密钥、证书与秘密生命周期总账、基线资产关键性、数据分类与风险分级总账、基线身份权限、特权访问与工作负载身份总账、基线处理活动、个人数据清单与
      RoPA 覆盖总账、基线隐私权利请求、同意偏好与合法基础执行总账、基线记录留存、法律保全与可防御删除总账、基线监管与合规义务可追溯总账、外部标准版本锁定、可执行标准、执行控制面、门禁决策、RACI 决策权、可靠性分级、仓库拓扑、迁移弃用、审计证据、联邦治理和行业对标矩阵的完整说明文档
  - path: .github/context/gongfa/README.md#doc-dataset-first-data-service
    title: Dataset First 数据服务结构
    role: dataset、contract、registry、runtime 为核心的数据服务模板
  - path: .github/context/gongfa/README.md#doc-code-organization
    title: 代码组织
    role: 模块化、命名、注释、格式化、文档和工具
  - path: .github/context/gongfa/README.md#doc-technology-stack
    title: 技术栈
    role: 技术栈选型、组合案例与学习路径
  - path: .github/context/gongfa/README.md#doc-programming-dao
    title: 编程之道
    role: 编程哲学、结构、状态、复杂度与工程判断
  - path: .github/context/gongfa/README.md#doc-common-sense
    title: 常识
    role: AI 编程和工程交付前的最低判断线
  - path: .github/context/gongfa/README.md#doc-development-experience
    title: 开发经验
    role: 变量名、文件结构、编码规范、架构原则和常见基础设施经验
  - path: .github/context/gongfa/README.md#doc-geo-seo-checklist
    title: GEO / SEO 检查清单
    role: 可信知识、结构化内容、审核与引用质量
top_level:
  context:
    path: .github/context
    purpose: 按需读取公开规则、知识、文档、数据与参考资料；研究档案仅保留本机副本
  skills:
    path: .github/skills
    purpose: 全部既有Skill指令与流程
  extensions:
    path: .github/extensions
    purpose: 既有程序、小工具、独立脚本与适配