mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-11-02 13:36:57 +00:00
feat: 完善法器体系并更新拼好码暂定分级 (#116)
* feat: faqi - 按Vibe Coding重要性分类并完善文档 * feat: gongfa - 修订拼好码暂定分级
This commit is contained in:
tradecatlabs
@@ -74,9 +74,9 @@ git push origin develop
|
||||
| `make sync-gongfa-catalog` | 从当前登记与仓内候选历史快照重建同一总表 | Python3.10+、scripts/requirements-gongfa.txt |
|
||||
| `make check-gongfa-catalog` | 只读校验总表来源SHA、覆盖及Markdown/Excel一致性 | 同上；不写原文或评级 |
|
||||
| `make test-gongfa-catalog` | 验证总表维护行为并保存隔离工件 | 同上；不证明功法效果 |
|
||||
| `make sync-faqi-catalog` | 重建法器来源初审与资源分流的只读清单 | Python3.10+、Git、scripts/requirements-faqi.txt、固定submodule |
|
||||
| `make check-faqi-catalog` | 只读校验法器JSON、来源Git/SHA、覆盖与清单一致性 | 同上；不执行工具或批准效果 |
|
||||
| `make test-faqi-catalog` | 验证法器维护消费与拒绝行为，保留隔离工件 | 同上；不证明身份语义、许可或能力 |
|
||||
| `make sync-faqi-catalog` | 重建法器总分类、重要性分级、依赖图对象与外部资源分流视图 | Python3.10+、Git、scripts/requirements-faqi.txt、固定submodule |
|
||||
| `make check-faqi-catalog` | 只读校验总登记、依赖图SHA/对象映射、来源Git/SHA与生成视图 | 同上；不执行工具或批准效果 |
|
||||
| `make test-faqi-catalog` | 验证总表维护消费与拒绝行为，保留隔离工件 | 同上；不证明身份语义、许可或能力 |
|
||||
| `make check-ai-citation` | 校验 llms 与 AI 引用语料路径、锚点和规范仓库身份 | Python 3 |
|
||||
| `make check-external-resources` | 校验本地外部资源注册表字段、分类统计、ID 与链接形态 | Python 3、PyYAML |
|
||||
| `make check-research-raw` | 校验研究域 raw 原始事实层、Git 工作树、来源清单和核心材料文件 | Python 3、Git |
|
||||
@@ -168,7 +168,7 @@ git push origin develop
|
||||
├── docs/ # 核心知识库
|
||||
│ ├── README.md # docs 总索引
|
||||
│ ├── getting-started/ # 从零开始、学习地图、环境、AI CLI 与第一个项目闭环
|
||||
│ └── gongfa/ # 思想、准则、模型、方法及配套文集的唯一正文源
|
||||
│ └── gongfa/ # 思想、准则、模型、方法及身份/法器配套说明的正文源
|
||||
│
|
||||
├── research/ # 研究对象与外部源事实镜像
|
||||
│ ├── README.md # research 总索引
|
||||
@@ -207,7 +207,7 @@ git push origin develop
|
||||
├── tools/ # 工具、本地配置与外部仓库
|
||||
│ ├── README.md # tools 目录说明
|
||||
│ ├── AGENTS.md # tools 目录规则
|
||||
│ ├── faqi-catalog.md # 法器初审的只读生成消费者
|
||||
│ ├── faqi-catalog.md # 法器总分类、重要性分级与依赖图对象的只读生成视图
|
||||
│ ├── config/ # 工具与开发配置（含 Codex CLI）
|
||||
│ ├── prompts-library/ # Excel ↔ Markdown 互转工具
|
||||
│ ├── chat-vault/ # AI 聊天记录保存工具
|
||||
@@ -225,8 +225,8 @@ git push origin develop
|
||||
│ ├── taxonomy.yml # 分类体系
|
||||
│ ├── glossary.yml # 术语表
|
||||
│ ├── redirects.yml # 重命名/迁移映射
|
||||
│ ├── faqi.json # 来源限定初审与资源逐ID分流
|
||||
│ ├── faqi.schema.json # 初审声明边界，不复制类型树
|
||||
│ ├── faqi.json # 法器总分类登记、重要性分级、依赖图对象与资源逐ID分流
|
||||
│ ├── faqi.schema.json # 总登记声明边界，复用唯一本体类型树
|
||||
│ └── gongfa/ # 功法登记、冻结来源、评级历史与单一总表（Markdown/Excel）
|
||||
│
|
||||
├── .github/ # GitHub 配置
|
||||
@@ -258,9 +258,9 @@ git push origin develop
|
||||
- `scripts/check-doc-structure.py` - docs README 标准块顺序、目录入口和重复锚点检查脚本，供 `make check-doc-structure` 与 CI 使用
|
||||
- `scripts/check-directory-docs.py` - 仓库自有目录 README/AGENTS 覆盖检查脚本，供 `make check-directory-docs` 与 CI 使用
|
||||
- `scripts/check-metadata.py` - metadata 路径与锚点检查脚本，供 `make check-metadata` 与 CI 使用
|
||||
- `metadata/faqi.json` / `faqi.schema.json` - 法器来源限定初审与字段契约，引用已有类型；不承接资源原事实、第二本体树、账户/部署/运行或品级；范围排除单列证据，不作为纳入对象。
|
||||
- `tools/faqi-catalog.md` - 从初审JSON与原资源YAML生成的只读清单，分列纳入对象及范围排除；源码初审不等于完整包语义、独立审查、许可或效果证明。
|
||||
- `scripts/sync-faqi-catalog.py` / `test-faqi-catalog.py` - 离线校验来源、入口、覆盖、排除边界与视图，保留隔离工件；不执行被审程序或联网补证。
|
||||
- `metadata/faqi.json` / `faqi.schema.json` - 法器总分类登记及字段契约；复用本体类型、固定来源审查、依赖图对象和用户确认纳入的依赖类别，原资源事实仍归资源YAML；当前暂定品级按Vibe Coding重要性分组，正式效能评级仍须独立效果证据。
|
||||
- `tools/faqi-catalog.md` - 从总登记与原资源YAML生成的只读视图，包含固定来源实现、依赖图具名对象、用户确认纳入的依赖类别、外部分流及品级状态；来源审查不等于许可或效果证明。
|
||||
- `scripts/sync-faqi-catalog.py` / `test-faqi-catalog.py` - 离线总表生成、检查及行为契约；核来源、图SHA、对象映射和品级边界，保留真实命令/结果；不执行被审程序或联网补证。
|
||||
- `metadata/gongfa/registry.json` - 活跃功法登记、等级、规则、来源、内容版本、人工初评及正式评级历史的唯一可编辑数据源；类型语义仍归本体主文；新范围追加批次
|
||||
- `metadata/gongfa/catalog.md` / `catalog.xlsx` - 同一全部功法总表的两种生成视图，聚合当前登记与已分类候选历史材料；不手改、不自动注册/去重/评级
|
||||
- `metadata/gongfa/catalog-sources.json` - 仅索引仓内不可变候选快照的路径/SHA/范围；历史材料不是第二可编辑登记，不依赖个人目录或临时工件
|
||||
@@ -278,7 +278,9 @@ git push origin develop
|
||||
- `docs/getting-started/README.md` - 从零开始索引入口，正文拆分到学习地图、网络配置、CLI 配置、开发环境搭建与第一个项目闭环；通用人机经验链接到功法
|
||||
- `docs/getting-started/first-project.md` - 用本地待办清单完成第一次可验证的需求、实现、验收与 Git 闭环
|
||||
- `docs/gongfa/README.md` - 方法论、哲学、思维模型、工程准则和流程的统一正文入口；完整文集按任务导航，文集数不是独立功法数
|
||||
- `docs/gongfa/faqi-system.md` - 法器分类边界、重要性分级、选用方式与登记入口；重要性不代表正式效能
|
||||
- 根 README 完整保留六条核心命题的只读展示，与功法体系分别使用同级原生 `<details>/<summary><strong>` 展开/收起；六命题正文维护源仍为 `docs/gongfa/ai-core-propositions.md`，同步展示不创建第二登记或内容版本。
|
||||
- 根 README 的“法器体系”块与功法块同级，使用不带`open`属性的`<details>`默认折叠；只放概要和链接，正文归`docs/gongfa/faqi-system.md`，登记归`metadata/faqi.json`，逐条生成视图归`tools/faqi-catalog.md`。
|
||||
- 首页其他方法只通过功法体系统一入口选择，不恢复经验、实验性方法、道法术器或哲学的独立栏目/分库；六命题历史锚点定位根页六命题展示，其他方法历史锚点定位功法块。首页徽章区仅保留独立目的地入口，统一使用 `<a><img>` 与紧凑 `style=flat`，保留其原href、顺序及完整alt；仅跳根README章节的目录徽章不放顶部，同一目标不重复展示（相对路径的 `./` 写法差异不算不同目标）。删除徽章不删除正文、折叠标题或历史锚点，不恢复旧快捷导航徽章组；单一段落不等于已验证所有视口视觉单行。
|
||||
- 首页入口收口、文集归并与逐条身份登记分别验收；无来源绑定不自动等于未登记功法，模板、术语、工具和本体说明不机械注册或赋级。
|
||||
- 研究回填矩阵、模板和AI摘要也按现行职责定位：方法/流程/清单正文归 `docs/gongfa/`，实例练习归 `docs/getting-started/`，具体事实留 `research/`；执行契约、工具配置和脚本分别归 `skills/`、`tools/config/`、`scripts/`，不把旧分类词当目录或批量改写上游结构。
|
||||
@@ -409,7 +411,7 @@ make test
|
||||
3. **Documentation Standard**: 用户文档使用中文；代码/文件名使用英文
|
||||
4. **Skills**: 每个技能有独立的 `SKILL.md`
|
||||
5. **Quality Gates**: `make test` 执行 Markdown lint、本地相对链接/锚点检查、折叠块结构检查、docs 结构检查、metadata 路径检查、AI 引用一致性检查、外部源事实镜像检查与现代企业架构 starter kit 检查；三个 `research/vibe-*` 目录按源事实镜像边界维护，仓库级格式检查跳过镜像内容。
|
||||
功法登记/总表与法器初审检查、相关测试纳入本地`make test`；GitHub Actions选定目标未改，不冒称新增远端覆盖。
|
||||
功法登记/总表与法器总分类登记检查、相关测试纳入本地`make test`；GitHub Actions选定目标未改，不冒称新增远端覆盖。
|
||||
|
||||
## Development Workflow
|
||||
|
||||
|
||||
@@ -23,9 +23,9 @@ help:
|
||||
@echo " sync-gongfa-catalog - 从当前登记与仓内候选快照重建唯一总表"
|
||||
@echo " check-gongfa-catalog - 只读校验总表覆盖、源摘要与Markdown/Excel一致性"
|
||||
@echo " test-gongfa-catalog - 验证总表维护行为并保留隔离工件"
|
||||
@echo " sync-faqi-catalog - 重建法器来源初审与资源分流的只读清单"
|
||||
@echo " check-faqi-catalog - 校验法器JSON、Git/SHA、覆盖与只读清单"
|
||||
@echo " test-faqi-catalog - 验证法器清单维护并保留隔离工件"
|
||||
@echo " sync-faqi-catalog - 重建法器总分类、依赖图对象与外部资源视图"
|
||||
@echo " check-faqi-catalog - 校验总登记、依赖图SHA、来源与只读视图"
|
||||
@echo " test-faqi-catalog - 验证总表维护并保留隔离工件"
|
||||
@echo " check-ai-citation - Check AI citation paths, anchors, and repository identity"
|
||||
@echo " check-external-resources - Check local external resources registry"
|
||||
@echo " check-research-raw - Check research raw fact snapshots and repository clones"
|
||||
|
||||
@@ -58,7 +58,23 @@
|
||||
|
||||
逐条身份、内容版本、冻结来源与已有意见查看[功法登记](metadata/gongfa/README.md)及上方总表。
|
||||
文集归并不等于全部内容已经逐条登记；已有初评也不等于正式效果验证。
|
||||
程序内容及外部资源所指的初审见[法器清单](tools/faqi-catalog.md)；清单区分纳入对象与按范围明确排除的程序证据，排除不代表其不是软件；源码核定不等于运行、许可或效果验证。
|
||||
|
||||
</details>
|
||||
|
||||
<a id="faqi"></a>
|
||||
<details>
|
||||
<summary><strong>🧰 法器体系</strong></summary>
|
||||
|
||||
## 法器体系
|
||||
|
||||
法器总表整理 Vibe Coding 流程中使用或依赖的工具、可调用入口和依赖类别；固定来源实现、当前运行实例、候选对象与抽象类别分别记录。
|
||||
|
||||
- [法器体系说明](docs/gongfa/faqi-system.md)：分类边界、重要性分级和选用方式。
|
||||
- [法器重要性总表](tools/faqi-catalog.md)：31 项的品级、名称、说明与记录状态。
|
||||
- [法器登记源](metadata/faqi.json)：唯一可编辑数据源；生成总表不可手改。
|
||||
- [法器类型与正式效能规约](docs/gongfa/cultivation-ontology-taxonomy.md#法器品级规约)：正式任务效果量表仍为草案。
|
||||
|
||||
当前 31 项按 Vibe Coding 重要性暂分天阶 5 项、地阶 12 项、玄阶 9 项、黄阶 5 项。重要性不代表实现质量、运行可用性或效能验证；正式效能评级尚未完成。
|
||||
|
||||
</details>
|
||||
|
||||
@@ -399,7 +415,7 @@ pip install -r tools/prompts-library/scripts/requirements.txt
|
||||
│
|
||||
├── docs/ # 核心知识库
|
||||
│ ├── getting-started/ # 从零开始、学习地图、环境与 AI CLI 配置
|
||||
│ └── gongfa/ # 思想、准则、模型、方法、流程及配套文集的唯一正文
|
||||
│ └── gongfa/ # 方法、流程、身份语义与法器分类说明的正文
|
||||
├── research/ # 根级研究域：新技术、优秀 repo 与工程范式研究
|
||||
├── prompts/ # 提示词库入口（指向云端表格）
|
||||
├── skills/ # 技能库入口
|
||||
@@ -407,11 +423,11 @@ pip install -r tools/prompts-library/scripts/requirements.txt
|
||||
│ ├── auto-tmux/ # tmux 自动化脚本、pane 巡检、救援与多终端协作
|
||||
│ └── claude-official-skills/ # Claude 官方 skills 软链接入口
|
||||
├── tools/ # 辅助工具、外部仓库与工具配置
|
||||
│ └── faqi-catalog.md # 法器来源初审与外部资源分流的只读视图
|
||||
│ └── faqi-catalog.md # 法器总分类、重要性分级与依赖图对象的只读视图
|
||||
├── scripts/ # 自动化脚本
|
||||
├── metadata/ # 机器可读索引与限定子域数据
|
||||
│ ├── faqi.json # 法器来源限定初审，不含品级或运行批准
|
||||
│ ├── faqi.schema.json # 初审字段契约，复用唯一BFO树
|
||||
│ ├── faqi.json # 法器总分类登记、依赖图对象与重要性分级
|
||||
│ ├── faqi.schema.json # 总登记字段契约，复用唯一BFO树
|
||||
│ └── gongfa/ # 功法登记、来源快照与单一总表（Markdown/Excel）
|
||||
├── assets/ # 静态资产、外部资源注册表与 AI 引用资产
|
||||
│
|
||||
|
||||
@@ -24,6 +24,8 @@
|
||||
| `docs/getting-started/first-project.md` | 第一次可验证的项目闭环 |
|
||||
| `docs/gongfa/README.md` | 方法论、哲学、思维模型、准则与流程的统一功法入口 |
|
||||
| `docs/gongfa/vibe-coding-cultivation-model.md` | BFO 下层展开的修仙通俗解释与任务战力评价 |
|
||||
| `docs/gongfa/faqi-system.md` | Vibe Coding工具与依赖分类、重要性分级和正式效能边界 |
|
||||
| `tools/faqi-catalog.md` / `metadata/faqi.json` | 法器重要性分级生成视图与唯一登记源；重要性不代表效能验证 |
|
||||
| `metadata/gongfa/README.md` | 功法JSON核心：限定内容、四阶十二级、未校准规则草案、冻结来源、人工分类/初评与正式评级历史；当前范围和数量见子域入口，不证明方法有效 |
|
||||
| `docs/gongfa/cultivation-ontology-taxonomy.md` | 固定 BFO 主干、身份、类型、内容版本与四阶十二级；已有初评、无正式效果评级 |
|
||||
| `docs/gongfa/thinking-models.md` | 哲学方法论与思维模型文集 |
|
||||
|
||||
@@ -66,6 +66,8 @@ GEOFlow 的关键启发是：GEO 不是关键词堆砌，而是内容工程链
|
||||
修为归属于模型版本，BFO 的直接能力承载另按运行实现处理；灵力是资源，不硬套心法＝认知模型、阵法＝Workflow。
|
||||
境界须有明确量表；战力先验收任务效果，再在同等合格结果下比较投入，不设通用永久等级。
|
||||
- docs/gongfa/cultivation-ontology-taxonomy.md：修仙领域唯一分类与语义契约入口（V4 BFO 草案）；BFO 2020 是固定前提，只展开其下层。
|
||||
- docs/gongfa/faqi-system.md：说明Vibe Coding工具/依赖的分类边界与重要性排序；重要性不等同于实现质量或正式效能评级。
|
||||
- tools/faqi-catalog.md 与 metadata/faqi.json：法器重要性分级的生成视图及唯一可编辑登记源；正式效能量表仍为未校准草案。
|
||||
根为 entity，其下为 continuant / occurrent；原生类保留 BFO ID 与继承，领域类有稳定 ID、工作定义、边界和依据，主父仅由唯一树维护。
|
||||
规约、方法和过程已进一步细分：判定标准不当结果，养成安排不等于施技要领，研习不证明已掌握；复合所指可留可靠上位类，预览不冒充完整规范。
|
||||
实体区分生物机体、制成器物、兵器构造、收纳容器、器物组群和围护内部场所；设计种类不随临时用途改变，组成、物体成员、所在及库存信息分别表达。
|
||||
|
||||
+5
-4
@@ -2,7 +2,7 @@
|
||||
|
||||
## 目录用途
|
||||
|
||||
`docs/` 是人类知识库：入门教程与功法体系分工。可复用方法论、哲学、思维模型、工程准则和流程的完整正文统一进入 `gongfa/`。
|
||||
`docs/` 是人类知识库：入门教程与功法体系分工。可复用方法论、哲学、思维模型、工程准则和流程的完整正文统一进入 `gongfa/`；法器体系说明作为配套分类参考留在该处，不维护第二份登记或效果总表。
|
||||
根级 `research/` 维护具体对象、原始事实与验证观察；稳定或待验证的可复用解释/方法正文归功法，保留来源与状态，移动不意味着验证通过。
|
||||
|
||||
## 目录结构
|
||||
@@ -12,14 +12,15 @@ docs/
|
||||
├── README.md # 知识库总导航
|
||||
├── AGENTS.md # docs 总操作规则
|
||||
├── getting-started/ # 学习路线、环境配置与第一个可验收练习
|
||||
└── gongfa/ # 思想、准则、模型、方法及配套文集的唯一正文位置
|
||||
└── gongfa/ # 思想、准则、模型、方法及身份/法器配套说明的正文位置
|
||||
```
|
||||
|
||||
## 关键入口
|
||||
|
||||
- `getting-started/README.md` 与 `AGENTS.md`：启动教程、环境、学习地图与最小实践的边界。
|
||||
- `gongfa/README.md`：按问题任务选择功法文集。
|
||||
- `gongfa/AGENTS.md`：正文、历史来源、登记、生成视图与研究/运行能力的职责分离。
|
||||
- `gongfa/README.md`：按问题任务选择功法文集并导航至法器配套说明。
|
||||
- `gongfa/faqi-system.md`：法器分类边界、重要性分级、选用方式与数据来源；不替代效能规约或生成总表。
|
||||
- `gongfa/AGENTS.md`：正文、历史来源、法器配套说明、登记、生成视图与研究/运行能力的职责分离。
|
||||
- `../metadata/gongfa/README.md`：功法身份、内容版本、已有初评和生成总表。
|
||||
- `../research/README.md` 与 `AGENTS.md`：具体对象的观测、原始事实和研究验证。
|
||||
|
||||
|
||||
+4
-1
@@ -4,6 +4,7 @@
|
||||
|
||||
- 新手从 [学习地图](getting-started/learning-map.md) 进入，配置环境并完成 [第一个项目](getting-started/first-project.md)。
|
||||
- 所有方法论、哲学、思维模型、工程准则与流程统一进入 [功法体系](gongfa/README.md)。
|
||||
- Vibe Coding 工具和依赖的分类边界、重要性排序及效能说明见[法器体系](gongfa/faqi-system.md)与[法器总表](../tools/faqi-catalog.md)。
|
||||
- 文集帮助理解和选用；逐条内容、来源与已有初评查看 [功法总表](../metadata/gongfa/catalog.md)。
|
||||
- 具体外部对象、原始材料和研究观察进入 [研究域](../research/README.md)，不与功法正文并行维护。
|
||||
- 可执行能力、工具与配置分别进入 [Skills](../skills/README.md) 和 [tools](../tools/README.md)。
|
||||
@@ -14,6 +15,7 @@
|
||||
|:---|:---|:---|
|
||||
| [getting-started](getting-started/README.md) | 环境、学习路线与第一次可验证实践 | [学习地图](getting-started/learning-map.md) / [第一个项目](getting-started/first-project.md) |
|
||||
| [gongfa](gongfa/README.md) | 思想、准则、模型和方法的统一组织与选用 | [问题求解](gongfa/problem-solving.md) / [思维模型](gongfa/thinking-models.md) / [质量门禁](gongfa/quality-gates-and-pitfalls.md) |
|
||||
| [法器体系](gongfa/faqi-system.md) | 工具、依赖类别、重要性分级及正式效能边界 | [体系说明](gongfa/faqi-system.md) / [重要性总表](../tools/faqi-catalog.md) |
|
||||
| [research](../research/README.md) | 外部对象的事实、机制、风险和验证观察 | [研究域契约](../research/research-domain-contract.md) / [研究转化](gongfa/research-transfer-synthesis.md) |
|
||||
|
||||
<details>
|
||||
@@ -43,7 +45,7 @@
|
||||
- [编程之道](gongfa/programming-dao.md) / [朴素真理](gongfa/software-engineering-truths.md) / [常识](gongfa/common-sense.md) / [开发经验](gongfa/development-experience.md)。
|
||||
- [质量门禁](gongfa/quality-gates-and-pitfalls.md) / [底层程序逻辑](gongfa/low-level-program-logic.md) / [GEO 检查](gongfa/geo-seo-checklist.md)。
|
||||
- [研究迁移综合](gongfa/research-transfer-synthesis.md) / [研究应用地图](gongfa/research-value-application-map.md) / [Harness](gongfa/harness-engineering.md) / [tmux 实验协作](gongfa/tmux-ai-swarm.md)。
|
||||
- [修仙解释](gongfa/vibe-coding-cultivation-model.md) / [统一本体](gongfa/cultivation-ontology-taxonomy.md)。
|
||||
- [修仙解释](gongfa/vibe-coding-cultivation-model.md) / [法器体系说明](gongfa/faqi-system.md) / [统一本体](gongfa/cultivation-ontology-taxonomy.md)。
|
||||
- [AGENTS](gongfa/AGENTS.md)：唯一正文、历史、版本和验证规则。
|
||||
|
||||
### 研究与数据
|
||||
@@ -52,6 +54,7 @@
|
||||
- [研究域契约](../research/research-domain-contract.md)：事实层、证据、成熟度和归档。
|
||||
- [源事实登记](../research/facts/README.md)：外部镜像、提交事实和隐私边界。
|
||||
- [功法登记](../metadata/gongfa/README.md) / [Markdown 总表](../metadata/gongfa/catalog.md) / [Excel](../metadata/gongfa/catalog.xlsx)：身份、来源与意见历史。
|
||||
- [法器登记与总表](../metadata/faqi.json) / [生成视图](../tools/faqi-catalog.md)：法器身份、依赖范围和重要性分级；正式效能评级仍未完成。
|
||||
- [docs AGENTS](AGENTS.md)：知识库目录总规则。
|
||||
|
||||
</details>
|
||||
|
||||
@@ -9,7 +9,7 @@
|
||||
- `metadata/gongfa/registry.json` 唯一维护已登记条目的 ID、内容版本、类型判定、来源绑定与历史意见；不另建可编辑功法表。
|
||||
- 功法文集不是独立功法身份。单篇可能包含多条内容或配套术语、本体与模板，不按篇数自动注册、去重或赋级。
|
||||
- 功法类型唯一语义源为 `cultivation-ontology-taxonomy.md`。本次仅移动原本体，不增节点、不把功能导航变成继承类树。
|
||||
- 本体说明、器物/资源资料与实验范式是配套内容，不把法器、修为或运行结果纳入功法四阶十二级。
|
||||
- 本体说明、器物/资源资料与实验范式是配套内容；法器不登记为功法、不复用功法等级值。`faqi-system.md`解释工具/依赖分类和重要性分级，逐条数据仍归`metadata/faqi.json`，只读视图归`tools/faqi-catalog.md`。正式效能评级按本体主文中的独立 `faqi-grade-vocabulary-v1` 草案另行评价；重要性排序不代表工具质量、运行能力或正式评级。来源初审与版本观测不构成效果证据。
|
||||
|
||||
## 职责地图
|
||||
|
||||
@@ -19,7 +19,7 @@
|
||||
- 构建与架构文集：拼好码、系统构建、项目/Python/企业架构、Dataset First、代码组织和技术栈。
|
||||
- 准则与验证文集：编程之道、朴素真理、常识、开发经验、质量门禁、底层逻辑与 GEO 检查。
|
||||
- 研究转化文集：研究迁移综合、应用地图、Harness 与实验性 tmux 协作；具体外部观察及 raw 仍归 research。
|
||||
- 身份语义文集：修仙解释与统一本体，负责内容/载体/版本/施行/能力/效果的分离。
|
||||
- 身份语义文集：修仙解释与统一本体，负责内容/载体/版本/施行/能力/效果的分离；[法器体系说明](faqi-system.md)是工具和依赖分类的配套参考。
|
||||
|
||||
## 内容与历史
|
||||
|
||||
|
||||
@@ -7,6 +7,7 @@
|
||||
- 阅读正文用下方文集；逐条身份、来源和已有初评查看[功法总表](../../metadata/gongfa/catalog.md)或[Excel](../../metadata/gongfa/catalog.xlsx)。
|
||||
- 文集可以包含多条功法和配套解释，不等于一门独立功法；迁移或篇幅不产生新身份与品级。
|
||||
- 内容分解释型、准则型、方法型；不可分复合保留上位类型。已有初评不是正式效果评级。
|
||||
- 法器体系是配套的工具与依赖分类参考，不是功法或效能榜；重要性分级见[法器体系说明](faqi-system.md)。
|
||||
- [本体与品级](cultivation-ontology-taxonomy.md#功法本体与品级)解释类型、内容版本和天地玄黄四阶十二级。
|
||||
|
||||
## 快速导航
|
||||
@@ -19,7 +20,8 @@
|
||||
| 要设计、组合或维护软件系统 | [拼好码](glue-coding.md) / [系统构建](system-building.md) / [项目架构](project-architecture-template.md) |
|
||||
| 要控制质量、复杂度或运行风险 | [质量门禁](quality-gates-and-pitfalls.md) / [朴素真理](software-engineering-truths.md) / [底层程序逻辑](low-level-program-logic.md) |
|
||||
| 要从研究提炼可验证改进 | [研究迁移综合](research-transfer-synthesis.md) / [研究应用地图](research-value-application-map.md) / [Harness 解析](harness-engineering.md) |
|
||||
| 要核对身份、类型、来源和品级 | [修仙解释](vibe-coding-cultivation-model.md) / [本体](cultivation-ontology-taxonomy.md) / [登记协议](../../metadata/gongfa/README.md) |
|
||||
| 要理解法器分类、重要性及正式效能边界 | [法器体系说明](faqi-system.md) / [法器总表](../../tools/faqi-catalog.md) / [本体规约](cultivation-ontology-taxonomy.md#法器品级规约) |
|
||||
| 要核对功法身份、类型、来源和初评 | [修仙解释](vibe-coding-cultivation-model.md) / [本体](cultivation-ontology-taxonomy.md) / [登记协议](../../metadata/gongfa/README.md) |
|
||||
|
||||
<details>
|
||||
<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
|
||||
@@ -73,6 +75,7 @@
|
||||
- [研究价值与应用地图](research-value-application-map.md)：研究到学习、工程和采用决策的转化。
|
||||
- [Harness 工程解析](harness-engineering.md)：控制面、评估器、反馈与可靠性判断。
|
||||
- [修仙解释图层](vibe-coding-cultivation-model.md)：领域本体的通俗解释，不是运行架构。
|
||||
- [法器体系说明](faqi-system.md)：工具/依赖边界、Vibe Coding重要性分级与正式效能评级边界。
|
||||
- [统一本体与分类设计](cultivation-ontology-taxonomy.md)：唯一类型树、身份、版本、来源及品级契约。
|
||||
- [AGENTS](AGENTS.md)：功法体系的正文维护与消费规则。
|
||||
|
||||
|
||||
@@ -13,6 +13,7 @@
|
||||
- 修为归属于模型；模型内容、能力的直接承载者、推理过程和评测记录不能混同。灵力、境界与战力仍各守原义。
|
||||
- [功法子域](#功法本体与品级)复用解释、准则、方法三条内容分支；条目、内容版本、来源、实际使用与品级分开。
|
||||
功法品级按用户确认采用《斗破苍穹》的**四阶十二级**；[JSON核心](../../metadata/gongfa/README.md)维护限定内容与来源，已完成人工分类与初评；判级规约仍未校准，初评不等于实测效果。
|
||||
- 法器另设独立四阶十二级任务效果规约，不成为功法、不复用功法等级记录。法器总表已有按 Vibe Coding 重要性进行的用户指定暂定分级；这不是效能评价，正式效能规约仍未校准且没有正式评级。
|
||||
- 整体研究仍以《逆天邪神》最高权重；功法品级单独注明《斗破苍穹》来源，已读事实、人物主张与项目约定分开，不编造跨小说通用等级。
|
||||
- 这是领域设计草案，不是已完成公理验证的 OWL 实现、运行架构或全仓本体。
|
||||
|
||||
@@ -510,6 +511,49 @@ JSON将词表、版本化规约、冻结来源、功法内容版本与评级记
|
||||
规则与范围见[JSON说明](../../metadata/gongfa/README.md#规则与评级)，验证入口为`make check-gongfa`与`make test-gongfa`。
|
||||
本轮不新增BFO类，不扩展全仓IR，也没有实际评级、运行引擎或发布。
|
||||
|
||||
## 法器品级规约
|
||||
|
||||
### 量表身份与适用对象
|
||||
|
||||
按用户要求借用功法品级的四阶十二级**结构**，但另建法器专属规约 `faqi-grading-policy`（版本 `0.1.0`，状态 `draft`）与量表 `faqi-grade-vocabulary-v1`；等级值使用 `faqi-` 前缀，与 `gongfa-grade-vocabulary-v1` 及其登记、初评和正式评级记录分开。
|
||||
这是项目的工具效果分级约定，不是玄幻作品的通用器物设定，也不把法器变成功法、BFO 类型、品质或永久能力。法器类别、使用角色、来源范围与品级结论是不同维度。
|
||||
被评对象至少绑定**实现身份与版本、任务族、使用环境**。同一工具可在不同任务族/条件下有不同结论；不同任务族不做总排名，不用单一最高级结果代表全部用途。组合工具可按明确的组合版本评整体，但不得从组件等级推导整体等级，组件也不自动继承组合项结论。
|
||||
|
||||
### 四阶方向
|
||||
|
||||
四阶沿用功法体系的顺序，实际判据改为法器在具体任务中的效果：
|
||||
|
||||
| 大阶 | 法器任务效果判据 | 必需比较 |
|
||||
|---|---|---|
|
||||
| 黄阶 | 在预先限定的常规任务范围内达到明确验收合同。 | 固定任务输入、环境、权限与成功条件；仅源码存在或宣传能力不足以证明达标。 |
|
||||
| 玄阶 | 在代表性常规任务中，相对合理基线产生可重复的净增益，且不降低正确性或关键约束满足度。 | 事先指定基线与增益指标；单个成功案例不能证明稳定增益。 |
|
||||
| 地阶 | 除满足前阶要求外，在预先定义的困难或迁移任务中仍达到增强合同，并保有相对基线的实用价值。 | 固定困难度/迁移维度、失败处理及恢复要求；留出未用于开发或调参的验证任务，不能从简单任务结果外推。 |
|
||||
| 天阶 | 除满足前阶要求外，关闭一个事前记录、基线确实无法满足的能力缺口，同时满足正确性、安全与权限合同。 | 缺口、基线及替代方案须在测试前登记；基线失败须可复核而非单次偶然；规模更大、功能更多或更快本身不构成突破。 |
|
||||
|
||||
同一任务范围内按最高连续通过大阶判定；高阶须同时满足对应低阶要求。判定顺序为正确性与硬约束 → 任务效果 → 可靠性 → 效率。安全、权限、隐私、数据完整性或不可逆副作用的关键违约是硬否决项，不能由速度或功能覆盖补偿。
|
||||
|
||||
### 每阶初、中、高
|
||||
|
||||
十二个值分别为黄/玄/地/天各自的初级、中级、高级；值 ID 按 `faqi-huang-initial` 等模式命名，与功法词表 ID 隔离。初/中/高表示**该大阶内预先定义的结果带**，不是测试次数、置信度、功能数量、代码量、用户量或等距倍率。
|
||||
|
||||
| 次级 | 判据 |
|
||||
|---|---|
|
||||
| 初级 | 达到本阶经校准的最低结果带；仍须通过正确性、硬约束和本阶任务合同。 |
|
||||
| 中级 | 达到本阶事先校准的中段结果带，并满足预注册的重复/代表性任务要求。 |
|
||||
| 高级 | 达到本阶事先校准的高段结果带，并在预选条件变化或留出任务中保持稳健，无关键回归。 |
|
||||
|
||||
每个任务族必须先定义可观察指标、结果带阈值及证据要求。阈值尚未校准时，不得把相应值作为可执行量表或正式评级；不得为填满十二格而降低标准或默认黄阶初级。
|
||||
|
||||
### 判级条件与证据
|
||||
|
||||
正式判级至少固定：法器 ID、实现版本与来源；任务族、任务集及事前验收合同；合理基线、环境/配置/依赖版本、权限、数据、资源预算与人工介入；规约版本、正确性/效果/可靠性/效率指标；可独立复核的运行结果和失败样本；结论理由、评定者、日期与证据引用。
|
||||
比较时控制工作负载、预算、环境及人工介入，避免把模型、提示词、硬件或操作者差异误归因给法器。版本、依赖或适用范围变化后重新评定，不自动继承旧等级。
|
||||
来源初审、代码静态阅读、功能列表、小说称呼或一次成功运行都不能单独形成效果等级。正式评级须满足任务合同与校准阈值；阈值未校准时不得宣称正式效果等级。2026-10-10，用户要求为全部未赋级条目暂列品级，登记先记录31条统一黄阶初级；2026-10-11，用户明确要求改按对Vibe Coding的重要性排序。当前`metadata/faqi.json`的31条暂定分级据此按核心模型/Agent、代码执行/变更基础、上下文/质量/交付增强、可替代专用支路排序。该目录使用的是重要性分组，不表示实现质量、任务效果、独立审查或正式评级；效能量表仍为draft，正式效能`grade_id`仍为空。未改变本体类型定义及来源限定实现数量。
|
||||
|
||||
本版为 `draft`：任务集、基线、环境预算和十二个结果带的数值阈值尚未校准。完成可复现任务合同和结果带校准前，不得写入具体评级或宣称跨任务可比较。
|
||||
|
||||
<!-- 用户授权审计：门禁=docs/gongfa/AGENTS.md#唯一维护边界、scripts/sync-faqi-catalog.py::render；用户原话摘要=“按照功法的分类体系先把……；执行”；时间=2026-10-10T08:10:55Z；绕过范围=仅为法器建立独立四阶十二级适配判据，不复用功法等级记录、不赋级、不声称效果；结果=规约草案已写入本体主文，法器来源初审仍未赋级。 -->
|
||||
|
||||
## 关键语义与世界观
|
||||
|
||||
> 修士定目标，依道法择路，借法器施行，耗灵力而求实效；修为看模型，战力看任务。
|
||||
@@ -908,6 +952,10 @@ PATO 只作选定词义对照，不复制其根、多继承或过程特征；不
|
||||
2026-10-07，按用户要求完成现有条目的人工分类与初评；JSON协议升为1.1.0，新增带任务族、理由、反证及历史链的初评批次。
|
||||
初评不是实测增益或独立评审；规约仍为未校准草案，原六条主类、全部内容原文、类型树、来源与旧判例保持。
|
||||
|
||||
2026-10-10，按用户要求为法器建立独立的四阶十二级适配规约；只定义任务效果方向、证据合同与否决边界，不复用功法等级记录，也不为任何候选赋正式效能等级。该规约仍为草案，阈值未校准。
|
||||
|
||||
2026-10-11，按用户确认将法器总表的暂定品级改为 Vibe Coding 重要性分类。此用途只表示核心模型/Agent、代码执行基础、上下文/质量/交付增强及专用辅助支路的相对重要性；正式任务效果规约和评级状态不变。
|
||||
|
||||
保留现有文件路径与 `唯一分类树` 锚点。README、AGENTS、metadata 与 AI 引用同步 BFO 定位、定义入口，不维护另一份树。
|
||||
此前本体轮未新增Schema或运行组件；本轮仅新增功法JSON协议与离线校验，不新增数据库、推理器或评级引擎。
|
||||
有限规模只读取登记的冻结来源，不引入网络请求、并发或服务运行成本。
|
||||
|
||||
@@ -0,0 +1,75 @@
|
||||
# Vibe Coding 法器体系说明
|
||||
|
||||
本文说明法器总表的对象边界、重要性分级和维护入口；具体来源事实与逐条分组以登记源和生成总表为准。
|
||||
|
||||
## 一句话
|
||||
|
||||
法器总表整理 Vibe Coding 流程中使用或依赖的工具、可调用入口及依赖类别，帮助读者理解它们在工作流中的位置。品级按对 Vibe Coding 的重要性暂定，不代表工具质量、运行可用性或任务效果。
|
||||
|
||||
## 字多不看
|
||||
|
||||
- 方法和能力要求归功法；工具、软件入口及依赖类别按其真实所指另行整理，不因出现在同一依赖图就变成同一种对象。
|
||||
- 当前 31 项按重要性分为天阶 5 项、地阶 12 项、玄阶 9 项、黄阶 5 项；完整名称、说明及分组见[法器总表](../../tools/faqi-catalog.md)。
|
||||
- 天阶强调模型推理与 Agent 协作；地阶强调代码操作、工具执行和运行基础；玄阶强调上下文、验证、复用与产品交付；黄阶强调可替代的专用或便利能力。
|
||||
- 每阶高级、中级、初级表示该阶内的重要性次序，不是测试结果带或效能等级。
|
||||
- 当前重要性分级与正式任务效果评级是两条独立轴；正式效能量表仍为 draft，阈值尚未校准。
|
||||
|
||||
## 对象边界
|
||||
|
||||
“法器”是本项目用于组织 Vibe Coding 工具与依赖能力的领域称呼，不等同于某个统一产品类别。登记必须按具体所指区分程序内容、当前运行实例、模型制品、服务/API、硬件资源、候选对象和抽象依赖类别。
|
||||
|
||||
总表中的不同记录不能仅凭名称、依赖图位置或功能相似而合并：
|
||||
|
||||
- **来源限定实现**：绑定选定的仓内来源和代码内容，不自动代表本机运行版本。
|
||||
- **运行实例或具名候选**：记录实际观察到的入口，或依赖图中指向的候选；候选身份、版本和来源可能仍待核。
|
||||
- **依赖类别**：例如模型服务、CI 平台、终端接口或检索记忆。用户确认类别纳入范围，不等于确认了某个产品、部署、账号或可用实现。
|
||||
- **外部资源行**：索引原资源记录，不等同于一件独立法器，也不单独证明能力、许可或运行效果。
|
||||
|
||||
法器不替代功法、任务合同或权限。建议使用某种工具，不代表它是唯一依赖、已获授权或已通过验证；执行一个过程也不自动证明预期效果。
|
||||
|
||||
## 重要性分级
|
||||
|
||||
本次排序面向一般 Vibe Coding 工作流，综合考虑条目在核心闭环中的作用、对代码执行和验证的支撑程度、适用范围及可替代性。分级是用户确认的导航性判断，并非从版本新旧、依赖图深度、代码规模或烟测结果计算出来的分数。
|
||||
|
||||
| 品级方向 | 重要性含义 | 常见角色 |
|
||||
|---|---|---|
|
||||
| 天阶 | 决定核心 AI 协作链能否成立 | 模型推理、Agent 运行与编排 |
|
||||
| 地阶 | 支撑代码真正被操作、运行和管理 | 终端命令、PTY、版本控制、语言与运行环境 |
|
||||
| 玄阶 | 扩展复杂任务的上下文、质量和交付范围 | 检索记忆、自动验证、技能复用、部署与数据集成 |
|
||||
| 黄阶 | 对特定工作方式有帮助，但通常存在替代路径 | 多会话终端、专用适配与格式转换 |
|
||||
|
||||
同阶内按高级、中级、初级表示重要性由高到低。等级只表示相对工作流位置：某项黄阶工具仍可能是某个具体任务的必要条件；高阶条目也不因此成为质量更好或已经可用的产品。
|
||||
|
||||
当前明细及每项分组理由以[生成总表](../../tools/faqi-catalog.md)为准。总表中的 10 项来源限定实现、13 项依赖图具名对象/运行观察和 8 项用户确认的依赖类别属于不同登记视角；9 条本地实现关联只是关联记录，不应重复计作新对象。158 条外部资源行也不等同于 158 件法器。
|
||||
|
||||
## 重要性与效能评级
|
||||
|
||||
| 维度 | 回答的问题 | 当前状态 |
|
||||
|---|---|---|
|
||||
| 重要性分级 | 该工具或类别在 Vibe Coding 工作流中有多关键、可由什么替代？ | 已按用户要求形成暂定排序，见法器总表。 |
|
||||
| 正式效能评级 | 某一固定实现、版本和任务环境是否达到明确效果合同？ | 量表仍为 draft；任务合同、基线和阈值未校准，当前没有正式效能结论。 |
|
||||
|
||||
来源审查、版本观察、静态阅读或单次烟测都不能替代固定任务合同和可复核的效果证据。登记状态也不等于独立审查、运行验证、许可证批准或安全授权。正式效能规约及证据条件见[统一本体中的法器品级规约](cultivation-ontology-taxonomy.md#法器品级规约)。
|
||||
|
||||
## 选用流程
|
||||
|
||||
1. 先定义要完成的任务、验收条件、环境和权限边界，不从最高品级反推工具选择。
|
||||
2. 从总表识别可能的工具或依赖类别，再核实具体实现、来源、版本和可用性；抽象类别不能直接当成已安装产品。
|
||||
3. 检查数据、网络、外部副作用、许可和恢复方式。类别纳入或版本观察不构成批准。
|
||||
4. 在适用任务中运行有界验证，保留成功与失败证据；验证范围不得超过实际测试的输入和环境。
|
||||
5. 若要提出正式效能评级，另按固定任务合同、合理基线、校准阈值和可复核结果评定，不沿用本页的重要性分组。
|
||||
|
||||
## 登记与维护
|
||||
|
||||
- [法器登记源](../../metadata/faqi.json)是唯一可编辑总登记；字段边界见[Schema](../../metadata/faqi.schema.json)。
|
||||
- [法器总表](../../tools/faqi-catalog.md)是由登记源和外部资源原表生成的只读视图，不手工编辑。
|
||||
- 外部资源的原始名称、地址、状态和风险仍由[外部资源登记](../../assets/external-resources/README.md)维护。
|
||||
- 正文类型及正式效能规约以[修仙领域统一本体](cultivation-ontology-taxonomy.md)为准；本页不另建分类树或实现身份库。
|
||||
|
||||
更新登记或生成视图时使用：
|
||||
|
||||
```bash
|
||||
make sync-faqi-catalog
|
||||
make check-faqi-catalog
|
||||
make test-faqi-catalog
|
||||
```
|
||||
+214
-31
@@ -1390,45 +1390,228 @@ Go 路线：
|
||||
<a id="reference-technology-stack-十六技术栈的层级结构"></a>
|
||||
### 十六、技术栈的层级结构
|
||||
|
||||
可以把技术栈理解成这样：
|
||||
普通技术栈图常把层级画成一条链，但 Vibe Coding 是带反馈回路、替代分支和可选节点的**有向依赖图**；构建/发布依赖子图可按DAG排序，运行反馈边另行回指。本节范围是从人的目标，经AI协作生成和验证软件，到可交付运行结果及反馈。
|
||||
|
||||
```text
|
||||
应用层：
|
||||
React、Vue、Flutter、Spring Boot、Django、FastAPI
|
||||
#### Vibe Coding 端到端依赖图
|
||||
|
||||
语言层：
|
||||
JavaScript、TypeScript、Java、Python、Go、C#、C++
|
||||
|
||||
数据层：
|
||||
MySQL、PostgreSQL、MongoDB、Redis、Elasticsearch
|
||||
|
||||
基础设施层：
|
||||
Linux、Docker、Kubernetes、Nginx、云服务器
|
||||
|
||||
工程工具层：
|
||||
Git、GitHub、CI/CD、测试工具、监控工具
|
||||
```mermaid
|
||||
flowchart TD
|
||||
Goal[目标与验收合同] -->|定义成功条件| Human[人类负责人与授权]
|
||||
Human -->|授权、取舍、验收| Agent[Agent运行时与协作循环]
|
||||
Goal -->|约束任务| Agent
|
||||
Agent -->|调用| Inference[模型推理接口]
|
||||
Inference -->|返回生成结果| Agent
|
||||
Repo[代码仓、配置、文档与Skill] -->|提供上下文| Context[Harness与上下文]
|
||||
Context -->|提供受限证据| Agent
|
||||
Agent -->|路由获准操作| Tools[工具调用接口]
|
||||
Tools -->|读写| Repo
|
||||
Tools -->|执行于| Host[主机OS、内核与隔离环境]
|
||||
Repo -->|源码与锁文件| Build[构建/运行/测试]
|
||||
Host -->|提供进程与资源| Build
|
||||
Toolchain[语言运行时、依赖、编译器] -->|执行| Build
|
||||
Build -->|产生| Artifact[可交付制品]
|
||||
Contract[测试合同与独立Oracle] -->|判定| Verify[验证结果]
|
||||
Artifact -->|被检查| Verify
|
||||
Verify -->|结果与失败样本| Agent
|
||||
Verify -->|通过的制品| Delivery[CI/CD、发布与托管]
|
||||
Delivery -->|部署到| Runtime[产品运行时、数据与外部服务]
|
||||
Runtime -->|日志、指标、故障| Observe[观测与用户反馈]
|
||||
Observe -->|更新问题与验收| Goal
|
||||
ModelAsset[模型版本与Tokenizer] -->|加载| Serving[本地或云端推理运行时]
|
||||
Serving -->|支撑| Inference
|
||||
Compute[CPU/GPU、内存、存储、网络、电力] -->|执行推理| Serving
|
||||
Hardware[固件、驱动与物理设备] -->|承载| Host
|
||||
```
|
||||
|
||||
更完整的结构：
|
||||
**依赖树按深度优先展开**：每个分支先递归到它的直接依赖叶节点，再展开同层下一个分支。`[AND]`表示都需要，`[OR]`表示可替代路径，`[可选]`表示不是最小闭环的硬依赖。深度表示依赖位置，不表示重要性或品级。
|
||||
|
||||
```text
|
||||
用户界面
|
||||
↓
|
||||
前端框架
|
||||
↓
|
||||
API 通信
|
||||
↓
|
||||
后端服务
|
||||
↓
|
||||
业务逻辑
|
||||
↓
|
||||
数据库 / 缓存 / 消息队列
|
||||
↓
|
||||
服务器 / 容器 / 云平台
|
||||
↓
|
||||
监控 / 日志 / 安全 / 自动化部署
|
||||
Vibe Coding 闭环 [目标 → 代码 → 独立验证 → 可验收结果；核心分支为 AND]
|
||||
├── 0. 目标与验收合同 [必需]
|
||||
│ ├── 用户问题、目标结果、非目标
|
||||
│ ├── 输入、输出、成功/失败条件
|
||||
│ ├── 约束：时间、成本、性能、安全、兼容性
|
||||
│ └── 验收依据与独立 Oracle
|
||||
│ ├── 业务规则/已知正确结果/测试合同
|
||||
│ └── 不从被测实现本身生成期望值
|
||||
│
|
||||
├── 1. 人类控制面 [必需]
|
||||
│ ├── 负责人：定目标、作取舍、验收结果
|
||||
│ ├── 身份与权限：谁可读、写、运行、发布
|
||||
│ ├── 预算：时间、模型调用、算力、网络与费用
|
||||
│ └── 反馈：纠偏、批准、拒收、变更目标
|
||||
│
|
||||
├── 2. AI 编码循环 [AI Vibe Coding 必需]
|
||||
│ ├── 2.1 Agent 运行时 [OR：选择一个具体实现]
|
||||
│ │ ├── Pi Agent〔当前候选；具体项目/版本待核〕
|
||||
│ │ ├── Codex / Claude Code / 其他 Agent〔替代项〕
|
||||
│ │ ├── 任务循环
|
||||
│ │ │ ├── 规划与状态
|
||||
│ │ │ ├── 上下文组装
|
||||
│ │ │ ├── 模型请求与响应解析
|
||||
│ │ │ ├── 工具路由与权限检查
|
||||
│ │ │ └── 失败、重试、取消与恢复
|
||||
│ │ └── Agent 进程本身
|
||||
│ │ ├── 对应产品要求的语言运行时/系统依赖
|
||||
│ │ └── 与“OS与隔离环境”分支相接，最终依赖内核、驱动、硬件与供电
|
||||
│ │
|
||||
│ ├── 2.2 模型推理 [OR：本地或云端]
|
||||
│ │ ├── 云端推理
|
||||
│ │ │ ├── 模型服务/API 与固定模型版本
|
||||
│ │ │ ├── 身份认证、配额、限流、计费与错误契约
|
||||
│ │ │ ├── DNS/TLS/网络连接
|
||||
│ │ │ │ └── 网卡/路由器/ISP或云网络/电力
|
||||
│ │ │ └── 服务商推理基础设施〔托管外部叶节点〕
|
||||
│ │ │ ├── 推理服务、模型制品与Tokenizer
|
||||
│ │ │ └── GPU/CPU、内存、存储、数据中心与供电
|
||||
│ │ └── 本地推理
|
||||
│ │ ├── 模型权重、Tokenizer、量化/配置版本
|
||||
│ │ ├── 推理引擎与依赖库
|
||||
│ │ ├── 驱动/运行时与OS内核
|
||||
│ │ └── 本地CPU/GPU、内存、存储、散热与供电
|
||||
│ │
|
||||
│ └── 2.3 Harness 与上下文 [需要充分上下文；具体组件可选]
|
||||
│ ├── 项目事实
|
||||
│ │ ├── 源码仓、README、架构/接口说明
|
||||
│ │ ├── AGENTS/项目约束、配置与锁文件
|
||||
│ │ └── 当前分支、变更、任务状态与历史证据
|
||||
│ ├── Prompt 与 Skill
|
||||
│ │ ├── Agent 系统/项目指令
|
||||
│ │ ├── 已有 Skill〔运行期被Agent消费〕
|
||||
│ │ └── Skill 制作支路 [可选；构建期，不是每次编码的前置]
|
||||
│ │ ├── auto-skill 模板生成脚本
|
||||
│ │ ├── auto-skill 结构校验脚本
|
||||
│ │ └── auto-skill Skill Seekers 适配脚本
|
||||
│ │ └── Skill Seekers 上游程序与其自身运行依赖
|
||||
│ ├── 检索/索引/记忆 [可选]
|
||||
│ │ ├── 文档或代码索引
|
||||
│ │ ├── 检索器与过滤/权限边界
|
||||
│ │ └── 向量库/缓存/记忆存储〔仅按需求〕
|
||||
│ └── 任务与评估状态
|
||||
│ ├── TODO、计划、未决项与证据
|
||||
│ └── 验收器/评估器及其独立数据
|
||||
│
|
||||
├── 3. 工具调用与代码操作 [至少有一条受控路径]
|
||||
│ ├── Agent 工具路由
|
||||
│ │ ├── 工具定义/参数Schema
|
||||
│ │ ├── 身份、权限、路径与副作用限制
|
||||
│ │ └── 调用结果、超时、错误与审计记录
|
||||
│ ├── 文件与代码
|
||||
│ │ ├── 文件系统读写
|
||||
│ │ ├── IDE/编辑器〔可选替代入口〕
|
||||
│ │ └── Git本地客户端与工作树
|
||||
│ ├── 命令/终端 [OR：直接终端或复用层]
|
||||
│ │ ├── 直接终端
|
||||
│ │ │ ├── Terminal Emulator / PTY
|
||||
│ │ │ ├── Shell 与命令解释器
|
||||
│ │ │ └── 进程、文件句柄、标准输入/输出
|
||||
│ │ └── tmux 复用支路 [可选]
|
||||
│ │ ├── tmux 终端复用程序
|
||||
│ │ │ ├── tmux CLI/Server/Socket
|
||||
│ │ │ └── 宿主OS的PTY、进程与权限能力
|
||||
│ │ ├── oh-my-tmux 配置〔依赖tmux与Shell；不是tmux本体〕
|
||||
│ │ └── auto-tmux 封装〔依赖tmux CLI、Shell与获准权限〕
|
||||
│ ├── 外部交互 [可选]
|
||||
│ │ ├── Browser/网页自动化
|
||||
│ │ ├── MCP/API/数据库客户端
|
||||
│ │ └── 网络、服务身份、授权与外部服务契约
|
||||
│ └── 上述所有工具进程
|
||||
│ └── 与“OS与隔离环境”分支相接，最终依赖内核、驱动、硬件与电力
|
||||
│
|
||||
├── 4. 项目与构建链 [交付代码变更时必需]
|
||||
│ ├── 4.1 项目输入
|
||||
│ │ ├── 源码、配置、文档、Schema、测试
|
||||
│ │ ├── 依赖清单与锁文件
|
||||
│ │ └── 版本控制基线与可复现工作树
|
||||
│ ├── 4.2 依赖获取 [OR：网络仓库或可信缓存]
|
||||
│ │ ├── 包管理器/依赖解析器
|
||||
│ │ ├── 包注册表、Git源或镜像
|
||||
│ │ ├── TLS/认证/完整性校验
|
||||
│ │ └── 解析后的具体依赖版本
|
||||
│ ├── 4.3 工具链
|
||||
│ │ ├── 语言与运行时
|
||||
│ │ ├── 编译器/解释器/代码生成器
|
||||
│ │ ├── 构建系统与链接器
|
||||
│ │ └── OS ABI、系统库与本机工具
|
||||
│ └── 4.4 构建结果
|
||||
│ ├── 可执行文件/包/容器镜像/静态资源
|
||||
│ └── 版本、来源、构建参数与摘要
|
||||
│
|
||||
├── 5. 独立验证闭环 [必需]
|
||||
│ ├── 目标合同与测试Oracle〔来自目标/验收分支，不由实现自证〕
|
||||
│ ├── 验证层级 [按风险选取]
|
||||
│ │ ├── 单元/组件
|
||||
│ │ ├── 集成/契约
|
||||
│ │ ├── E2E/真实环境〔必要时〕
|
||||
│ │ ├── Lint/类型/静态与安全检查
|
||||
│ │ └── 性能/资源/成本测量〔有目标时〕
|
||||
│ ├── 测试数据、隔离环境、固定时钟/随机源
|
||||
│ ├── 失败样本、退出码、日志与可复现命令
|
||||
│ └── 验证结果
|
||||
│ ├── 失败 → 返回Agent/人类修正
|
||||
│ └── 通过 → 允许进入交付分支
|
||||
│
|
||||
├── 6. OS 与隔离环境 [有受控执行环境必需；实现可替换]
|
||||
│ ├── 6.1 承载路径 [OR；按任务选择]
|
||||
│ │ ├── 原生主机
|
||||
│ │ │ ├── Windows/macOS
|
||||
│ │ │ └── Linux主机
|
||||
│ │ │ └── Linux内核
|
||||
│ │ │ └── 发行版/用户空间 [OR]
|
||||
│ │ │ ├── Ubuntu〔候选；具体来源/版本待核〕
|
||||
│ │ │ └── 其他发行版
|
||||
│ │ ├── Windows主机
|
||||
│ │ │ └── WSL〔候选；具体版本/来源待核〕
|
||||
│ │ │ ├── Windows宿主与互操作边界
|
||||
│ │ │ ├── 版本对应的兼容层/虚拟化与Linux内核
|
||||
│ │ │ └── Linux发行版/用户空间 [OR；可选Ubuntu]
|
||||
│ │ ├── VM/远程开发机
|
||||
│ │ │ └── Guest OS → Kernel → 发行版/用户空间〔可选Ubuntu〕
|
||||
│ │ └── 容器
|
||||
│ │ ├── OCI运行时与镜像
|
||||
│ │ └── 共享宿主内核〔不是独立完整内核〕
|
||||
│ ├── 6.2 OS运行基础
|
||||
│ │ ├── 内核、系统调用与进程调度
|
||||
│ │ ├── 文件系统、权限、用户/组与设备访问
|
||||
│ │ ├── 网络栈、DNS、证书与防火墙
|
||||
│ │ └── Shell、系统库、服务管理与环境变量
|
||||
│ └── 6.3 OS以下
|
||||
│ ├── 驱动与固件/微码/启动固件
|
||||
│ └── 物理设备、网络链路与电力底座
|
||||
│
|
||||
├── 7. 交付与运行 [仅面向交付/上线的任务必需]
|
||||
│ ├── 7.1 CI/CD
|
||||
│ │ ├── Git托管与触发器
|
||||
│ │ ├── CI Runner与其OS/工具链
|
||||
│ │ └── 构建、验证、制品签名/发布策略
|
||||
│ ├── 7.2 制品与发布
|
||||
│ │ ├── 制品/镜像注册表
|
||||
│ │ ├── 部署配置、权限与密钥注入
|
||||
│ │ └── 回滚/恢复机制
|
||||
│ └── 7.3 产品运行环境
|
||||
│ ├── 应用运行时与主机/容器/云平台
|
||||
│ ├── 数据库、对象存储、队列与外部API
|
||||
│ ├── 身份/密钥/网络/备份
|
||||
│ └── 日志、指标、追踪、告警与用户反馈
|
||||
│
|
||||
└── 8. 物理与外部底座 [终止叶节点需标注托管边界]
|
||||
├── 本地工作站/服务器：CPU/GPU、RAM、磁盘、网卡、散热
|
||||
├── 云端推理/构建/生产服务商的数据中心与计算设备
|
||||
├── 固件、驱动、微码与硬件供应商
|
||||
├── 电力、通信运营商、ISP、DNS与时间服务
|
||||
└── 芯片制造及更上游供应链〔本图登记为外部依赖，不无限递归〕
|
||||
```
|
||||
|
||||
这棵树是依赖关系的深度优先投影；共享依赖会在多个分支出现，真实模型仍是图而非树。图中的边须区分 `depends_on`、`runs_on`、`calls`、`reads/writes`、`builds`、`verifies`、`deploys_to` 与 `observes/feeds_back`，并标注必需/可选/替代、身份版本、证据、权限及失败传播。
|
||||
|
||||
**最小可行闭环**至少需要：明确目标与验收、人类授权、Agent/模型能力、足够且可信的项目上下文、受控工具执行、项目构建或直接运行方式、独立验证。部署不是所有 Vibe Coding 任务的必需条件；模型可本地/云端二选一，OS与隔离环境有多个替代方案。tmux、Skill生成器、RAG、云部署等是按任务选用的可选分支，不能画成所有项目的硬依赖。
|
||||
|
||||
跨层不变量包括凭据/身份、最小权限、隐私与数据完整性、来源和版本溯源、预算/配额、失败隔离/回滚、独立验证及可观测性。它们应附着到相应节点和边，而不是伪装成一个“安全层”后就认为全链路安全。
|
||||
|
||||
“完整”只对**一个固定配置及交付范围**成立：沿图递归到可管理的外部叶节点（例如模型服务、网络、操作系统、硬件），并标明由谁托管、版本/契约及不可见部分。不能声称把所有云供应链、芯片制造与电力系统无限展开后得到全宇宙完整图。
|
||||
|
||||
因此，先按依赖图定位和确认边，再按**具体任务合同**评估工具效果；图的深度、节点数量、名气或“基础程度”都不能直接推出黄/玄/地/天品级。
|
||||
|
||||
---
|
||||
|
||||
<a id="reference-technology-stack-十七技术栈示例总表"></a>
|
||||
|
||||
@@ -7,6 +7,7 @@
|
||||
- 修为属于模型，灵力是资源；境界依赖量表，战力评价具体任务，先效果后效率。
|
||||
- 模型内容、能力的直接承载者、软件入口、实际运行和记录分别判断；不因引入本体就复制同一对象。
|
||||
- 工程功法已建立[条目与品级契约](cultivation-ontology-taxonomy.md#功法本体与品级)：四阶十二级与类型分开；[JSON核心](../../metadata/gongfa/README.md)维护限定内容、来源、人工分类与初评；暂定品级不是效果实测。
|
||||
- 法器另有独立[任务效果品级规约](cultivation-ontology-taxonomy.md#法器品级规约)，不与功法等级互换；正式效能量表仍未校准，当前总表的暂定品级仅按Vibe Coding重要性排序，不代表效能评级。
|
||||
- 本页不另画分类树，也不证明 AI 有意识、授予权限或宣称已通过形式化验证。
|
||||
|
||||
## 这张图层如何阅读
|
||||
|
||||
@@ -10,7 +10,7 @@ vibe-coding-cn 是一个中文 Vibe Coding / AI 结对编程系统教程，帮
|
||||
核心内容：
|
||||
- Quick Start：1 分钟开始 Vibe Coding
|
||||
- 六条核心命题：以固定目标、可变策略、分层反馈的可验证收敛系统为总纲，涵盖 AI 生成域、模型吞噬、隔离审查和能力编排等底层命题
|
||||
- 修仙解释图层：固定 BFO 2020 主干的 V4 草案，领域类有稳定 ID、定义、边界与来源；实体、品质、内容和过程分开，组成/用途/所在不当继承，器物设计须有依据；制备、观测与再生链区分计划/执行/记录/评价，输出不必新生或合格，局部改善和前提满足不等于完整效果；整体/部分/角色/状态分层判身份，复合所指可停上位类，预览和意向不补作结果；功法JSON核心整理限定内容、版本与冻结来源，当前收录见子域入口，采用《斗破苍穹》四阶十二级，已人工分类/初评，规约未校准、无正式效果评级，等级不作为类型父子；魂魄是完整 AI 会话过程，万魂幡是会话类外延；模型版本归属不等于能力直接承载，资源口径分开，境界绑定量表，战力先效果后效率
|
||||
- 修仙解释图层：固定 BFO 2020 主干的 V4 草案，领域类有稳定 ID、定义、边界与来源；实体、品质、内容和过程分开，组成/用途/所在不当继承，器物设计须有依据；制备、观测与再生链区分计划/执行/记录/评价，输出不必新生或合格，局部改善和前提满足不等于完整效果；整体/部分/角色/状态分层判身份，复合所指可停上位类，预览和意向不补作结果；功法JSON核心整理限定内容、版本与冻结来源，当前收录见子域入口，采用《斗破苍穹》四阶十二级，已人工分类/初评，规约未校准、无正式效果评级，等级不作为类型父子；法器总表按Vibe Coding重要性暂分级，不代表工具质量或效能，正式任务效果规约仍未校准；魂魄是完整 AI 会话过程，万魂幡是会话类外延；模型版本归属不等于能力直接承载，资源口径分开，境界绑定量表，战力先效果后效率
|
||||
- Getting Started：从零开始的环境、网络、Codex CLI、开发环境配置与第一个项目闭环
|
||||
- Prompt Library：提示词库
|
||||
- Skills：技能库
|
||||
@@ -39,6 +39,7 @@ vibe-coding-cn 是一个中文 Vibe Coding / AI 结对编程系统教程，帮
|
||||
- docs/gongfa/vibe-coding-state-transition.md
|
||||
- docs/gongfa/vibe-coding-cultivation-model.md
|
||||
- docs/gongfa/cultivation-ontology-taxonomy.md
|
||||
- docs/gongfa/faqi-system.md
|
||||
- docs/gongfa/glue-coding.md
|
||||
- docs/gongfa/system-building.md
|
||||
- docs/gongfa/development-paradigms.md
|
||||
|
||||
+11
-6
@@ -23,14 +23,14 @@
|
||||
- 候选来源保留旧编者意见并明确未登记；不同限定内容和同名条目不自动合并或继承品级。
|
||||
- 更新后运行`make sync-gongfa-catalog`、`make check-gongfa-catalog`及`make test-gongfa-catalog`，不手改生成视图。
|
||||
|
||||
## 法器来源初审
|
||||
## 法器总分类登记
|
||||
|
||||
- `faqi.json`唯一拥有来源限定实现初审、选区用途与资源逐ID分流；字段契约为`faqi.schema.json`，不是正式身份/效果或运行登记。
|
||||
- 类型只引用唯一本体；原资源ID、名称、地址、状态、验证状态和风险仍归`assets/external-resources/`分类YAML，不复制为第二登记。
|
||||
- 程序内容与Skill规约、配置、模型、载体、副本、地址、账号、部署及一次运行按真实所指区分，不按目录/后缀、同名、多入口机械合并或新增身份。
|
||||
- `faqi.json`是法器总分类登记的唯一可编辑源：包含固定来源实现初审、Vibe Coding依赖图具名对象/实例、用户确认纳入的依赖类别、暂定品级记录及外部资源逐ID分流；字段契约由`faqi.schema.json`约束。
|
||||
- 类型只引用唯一本体；原资源ID、名称、地址、状态、验证状态和风险仍归`assets/external-resources/`分类YAML，不复制为第二资源登记。
|
||||
- 程序内容、运行实例、模型、服务、硬件、信息内容、过程、地址及账号按真实所指分离；用户可确认依赖类别纳入范围，但该确认不自动补出具体产品身份、版本或任务效果等级。
|
||||
- 来源用途是人工初审标注，Schema/后缀/SHA不能证明语义正确；`exclusion_evidence`不能作为纳入对象实现来源。每个空纳入入口至少有一条显式排除记录；同一入口可列多项排除对象，按入口路径与名称去重，排除来源分别唯一绑定，不能静默复入。
|
||||
- 独立审查、运行、效果、许可与品级声明固定未批准；用户限定范围排除不代表否定其程序性质。
|
||||
- 固定来源修订、原字节SHA与一基半开选区；新内容/版本重新核身份，不继承旧能力，不覆盖旧Git来源事实。
|
||||
- `faqi-grade-vocabulary-v1`仍为draft且效能结果带阈值未校准；正式效能评级与当前`provisional_grade_assignments`的重要性分级是不同轴。用户要求暂按Vibe Coding核心模型/Agent、代码执行与变更基础、质量/上下文/产品交付增强、可替代专用支路分层；各阶初中高表示阶内重要性，不表示效果或实现质量。运行时对象正式`grade_id`仍为null，效能验证仍为false。
|
||||
- 固定来源修订、原字节SHA与一基半开选区；新内容/版本重新核身份，不继承旧能力，不覆盖旧Git来源事实。依赖图文本SHA与观测时间分别绑定，不冒称固定源码来源。
|
||||
- `tools/faqi-catalog.md`只读生成；运行`make sync-faqi-catalog`、`make check-faqi-catalog`、`make test-faqi-catalog`，保留真实工件。
|
||||
|
||||
## 验证
|
||||
@@ -43,3 +43,8 @@ make check-gongfa
|
||||
make test-gongfa
|
||||
make test
|
||||
```
|
||||
|
||||
<!-- 用户授权审计：门禁=metadata/AGENTS.md#法器来源初审、docs/gongfa/AGENTS.md#唯一维护边界；用户原话摘要=“从完整依赖图提取工具、平台等对象，更新法器总分类评级表并打印”；时间=2026-10-10T13:32:28Z；绕过范围=将法器登记/只读视图扩展为总分类与依赖图观察表；不绕过分级证据门槛，等级保持待核；结果=登记v2列入13个具名对象/运行观察、9个仓内图节点关联及8个未具体化节点，原10项来源实现与外部资源分流保留。 -->
|
||||
<!-- 用户授权审计：门禁=metadata/AGENTS.md#法器总分类登记中的依赖类别待核边界；用户原话摘要=“待核的我全部核查过了，开始执行分类，全部进入”“全部纳入”；时间=2026-10-10T14:28:10Z；绕过范围=将8个依赖图类别由待核身份改为用户确认纳入评估范围；不推断具体实现、版本或品级，不绕过效能分级证据门槛；结果=8类均标记user_confirmed_in_scope并纳入生成视图，正式等级仍未赋值。 -->
|
||||
<!-- 用户授权审计：门禁=docs/gongfa/cultivation-ontology-taxonomy.md#法器品级规约（draft阈值未校准、不得默认最低档）；用户原话摘要=“给全部NULL／未赋级赋予品级”；时间=2026-10-10T17:10:19Z；绕过范围=为原25条未赋级记录暂列黄阶初级，其中8条依赖类别按用户确认纳入，已有6条烟测记录保留具体任务范围；这是可撤销的用户授权分组，不声称效能已验证或正式评级；结果=31条登记均有暂定品级记录，生成视图按天、地、玄、黄分组，正式效能验证仍为false。 -->
|
||||
<!-- 用户授权审计：门禁=docs/gongfa/cultivation-ontology-taxonomy.md#法器品级规约（品级按任务效果定义）与metadata/AGENTS.md#法器总分类登记（暂定品级边界）；用户原话摘要=“按照对于vibecoding重要性排序作为品级分类”；时间=2026-10-11T06:19:20Z；范围=全部31条法器/依赖对象及类别的暂定品级，从统一黄阶初级改为按核心闭环重要性、执行关键性、上下文/质量/交付作用及可替代性排序；结果=天5、地12、玄9、黄5，仍不代表效能验证、实现质量或正式评级，正式效能grade_id保持null；此前烟测未用于重要性排序：Skill Seekers创建因缺PyMuPDF未运行成功、auto-tmux doctor因脚本Git mode为100644失败，其他高副作用路径未运行，记录仍见/tmp/faqi-rating.WdWHPQ/rating-report.md。 -->
|
||||
|
||||
+5
-4
@@ -8,9 +8,10 @@
|
||||
- `taxonomy.yml`：知识库分类、阅读路径和关键文档入口。
|
||||
- `glossary.yml`：项目术语表。
|
||||
- `redirects.yml`：已经不存在的历史路径到当前入口的映射，供维护和 AI 上下文使用。
|
||||
- [faqi.json](faqi.json)：来源限定的法器实现初审及外部资源逐ID分流的唯一可编辑判定；原资源事实仍归分类YAML。
|
||||
- [faqi.schema.json](faqi.schema.json)：首批程序内容初审的字段与声明边界，不复制本体父链或维护能力、许可、品级。
|
||||
- [法器清单](../tools/faqi-catalog.md)：上述初审与原资源事实的生成视图；不手改，不把候选自动晋升为已核程序。
|
||||
- [faqi.json](faqi.json)：法器总分类登记唯一可编辑源，汇总来源限定实现、依赖图具名对象/运行观察、用户确认纳入的依赖类别与外部资源逐ID分流；原资源事实仍归分类YAML。
|
||||
- [faqi.schema.json](faqi.schema.json)：总登记 v2 字段契约，复用本体类型；不复制父链，并区分用户指定的重要性暂定分级与正式效能评级。
|
||||
- [法器体系说明](../docs/gongfa/faqi-system.md)：解释工具/依赖边界、重要性分级及正式效能评价边界；不复制登记或生成总表。
|
||||
- [法器总表](../tools/faqi-catalog.md)：总登记与原资源事实的生成视图；包括本地实现、图中现实对象、用户确认纳入的依赖类别和重要性分级；正式效能评级仍未赋值，不手改。
|
||||
- [gongfa/](gongfa/README.md)：功法JSON核心、限定内容、四阶十二级、人工分类/初评、冻结来源与正式评级历史。
|
||||
- [功法总表](gongfa/catalog.md)／[Excel完整视图](gongfa/catalog.xlsx)：当前登记与已分类来源候选的同一总视图；聚合数量由生成器维护，不复制分批表。
|
||||
|
||||
@@ -19,7 +20,7 @@
|
||||
功法检查需要Python3.10+及`python3 -m pip install -r scripts/requirements-gongfa.txt`。
|
||||
法器维护需要Python3.10+、Git与`scripts/requirements-faqi.txt`；submodule须按父仓库固定指针初始化。
|
||||
更新法器来源或实现内容须核身份/版本，保留旧Git修订及旧记录，不把同名、副本、声明版本或源码变化自动当能力升级。
|
||||
当前10项纳入；Chat Vault、MC Player Transfer、XHS ZIP→PDF、HTML工具五项及my-nvim共9项保留为明确范围排除和源码证据，不作为faqi对象；复入前须按各自记录重新核验。
|
||||
当前固定来源实现10项；依赖图另列13项具名对象/运行观察及8项由用户确认纳入的依赖类别，不与固定来源实现数相加冒称独立产品数。31项按对Vibe Coding的重要性分布于天5、地12、玄9、黄5；此轴表示依赖角色重要性，不表示效能。正式法器效果量表仍为draft且阈值未校准，正式效能评级仍为空。Chat Vault、MC Player Transfer、XHS ZIP→PDF、HTML工具五项及my-nvim共9项仍为明确范围排除；复入前须按各自记录重新核验。
|
||||
独立语义、运行、效果和许可批准不在此初审格式内；未经相应证据，不修改声明边界。
|
||||
|
||||
修改目录、锚点、阅读路径或关键入口后，必须同步更新本目录，并运行：
|
||||
|
||||
+254
-5
@@ -1,19 +1,268 @@
|
||||
{
|
||||
"format_version": 1,
|
||||
"kind": "faqi-initial-source-review",
|
||||
"reviewed_at": "2026-10-10T04:30:59+00:00",
|
||||
"format_version": 2,
|
||||
"kind": "faqi-master-classification-register",
|
||||
"reviewed_at": "2026-10-11T06:19:20+00:00",
|
||||
"source_revision": "0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2",
|
||||
"ontology": {
|
||||
"path": "docs/gongfa/cultivation-ontology-taxonomy.md",
|
||||
"sha256": "a3551b72b1acc5692681d27f25155b95bddc817dcc12e9ef3167b7f1ebea0a4e"
|
||||
"sha256": "4965b8389e546eaa5ea8eb9103d252e1d1f8113959eeadc83f5edda5ba97df75"
|
||||
},
|
||||
"dependency_graph": {
|
||||
"source_path": "docs/gongfa/technology-stack.md",
|
||||
"source_sha256": "88ff3494095c2a794acf130d5d2ccc4eb4b67ccdc8c174e7ef09f35c11a450a2",
|
||||
"source_anchor": "reference-technology-stack-十六技术栈的层级结构",
|
||||
"observed_at": "2026-10-10T12:14:00Z",
|
||||
"user_confirmation": {
|
||||
"reviewed_at": "2026-10-10T14:28:10Z",
|
||||
"statement": "用户确认此前列出的8类待核依赖均已核查，并要求全部纳入分类。",
|
||||
"scope": "8类依赖均作为已核验范围条目纳入；不据此补造具体产品身份、版本或任务效果等级。"
|
||||
},
|
||||
"objects": [
|
||||
{
|
||||
"id": "dep-pi-cli",
|
||||
"name": "Pi Agent CLI（当前 PATH 实例）",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "2.1 Agent运行时 / Pi Agent",
|
||||
"identity_status": "runtime_observed",
|
||||
"version": "1.1.0",
|
||||
"evidence": "pi --version 输出 1.1.0；type -a 显示多个同名入口，本记录只绑定当前 shell 选中的入口；先前环境记录为 1.0.4，宿主/路径差异待核，不将此版本绑定到会话服务端。",
|
||||
"resource_ids": [],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "分级量表仍为 draft，初/中/高结果带阈值未校准；本条未建立任务族效果合同。"
|
||||
},
|
||||
{
|
||||
"id": "dep-codex-cli",
|
||||
"name": "Codex CLI（依赖图替代项）",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "2.1 Agent运行时 / Codex替代项",
|
||||
"identity_status": "named_candidate",
|
||||
"version": null,
|
||||
"evidence": "依赖图及外部资源行指向 Codex CLI 候选；当前安装身份、可执行入口、版本与来源未核。",
|
||||
"resource_ids": ["tools-platforms-codex-cli-362bc20a"],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "精确实现/版本、任务合同及分级量表阈值待核。"
|
||||
},
|
||||
{
|
||||
"id": "dep-claude-code",
|
||||
"name": "Claude Code（依赖图替代项）",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "2.1 Agent运行时 / Claude Code替代项",
|
||||
"identity_status": "named_candidate",
|
||||
"version": null,
|
||||
"evidence": "依赖图及外部资源行指向 Claude Code 候选；当前安装身份、可执行入口、版本与来源未核。",
|
||||
"resource_ids": ["tools-platforms-claude-code-11b1e88d"],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "精确实现/版本、任务合同及分级量表阈值待核。"
|
||||
},
|
||||
{
|
||||
"id": "dep-wsl2-platform",
|
||||
"name": "WSL 2 承载平台",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "6.1 Windows主机 / WSL",
|
||||
"identity_status": "runtime_observed",
|
||||
"version": null,
|
||||
"evidence": "uname -r 含 microsoft-standard-WSL2，确认当前 Linux 内核运行在 WSL2 兼容环境；Windows宿主版本及 WSL 产品版本未核。",
|
||||
"resource_ids": [],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "承载平台精确版本、任务合同及分级量表阈值待核。"
|
||||
},
|
||||
{
|
||||
"id": "dep-ubuntu-userland",
|
||||
"name": "Ubuntu 用户空间发行版",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "6.1 Linux发行版 / Ubuntu",
|
||||
"identity_status": "runtime_observed",
|
||||
"version": "24.04.3 LTS",
|
||||
"evidence": "/etc/os-release 报告 Ubuntu 24.04.3 LTS（VERSION_ID=24.04）。",
|
||||
"resource_ids": [],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "版本观测不等于具体任务效果；分级量表阈值未校准。"
|
||||
},
|
||||
{
|
||||
"id": "dep-wsl2-kernel",
|
||||
"name": "WSL2 Linux 内核",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "6.1 WSL / 版本对应的Linux内核",
|
||||
"identity_status": "runtime_observed",
|
||||
"version": "6.6.87.2-microsoft-standard-WSL2",
|
||||
"evidence": "uname -r 输出 6.6.87.2-microsoft-standard-WSL2；不据内核版本推断 Windows/WSL 产品版本。",
|
||||
"resource_ids": [],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "版本观测不等于具体任务效果；分级量表阈值未校准。"
|
||||
},
|
||||
{
|
||||
"id": "dep-bash",
|
||||
"name": "GNU Bash",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "6.2 Shell与命令解释器",
|
||||
"identity_status": "runtime_observed",
|
||||
"version": "5.2.21",
|
||||
"evidence": "bash --version 输出 GNU bash 5.2.21。",
|
||||
"resource_ids": [],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "版本观测不等于具体任务效果；分级量表阈值未校准。"
|
||||
},
|
||||
{
|
||||
"id": "dep-python-runtime",
|
||||
"name": "Python 运行时",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "4.3 语言与运行时",
|
||||
"identity_status": "runtime_observed",
|
||||
"version": "3.12.3",
|
||||
"evidence": "python3 --version 输出 Python 3.12.3。",
|
||||
"resource_ids": [],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "版本观测不等于具体任务效果；分级量表阈值未校准。"
|
||||
},
|
||||
{
|
||||
"id": "dep-nodejs-runtime",
|
||||
"name": "Node.js 运行时",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "4.3 语言与运行时",
|
||||
"identity_status": "runtime_observed",
|
||||
"version": "22.23.2",
|
||||
"evidence": "node --version 输出 v22.23.2。",
|
||||
"resource_ids": [],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "版本观测不等于具体任务效果；分级量表阈值未校准。"
|
||||
},
|
||||
{
|
||||
"id": "dep-npm-npx",
|
||||
"name": "npm / npx 工具",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "4.2 包管理器与依赖解析器",
|
||||
"identity_status": "runtime_observed",
|
||||
"version": "10.9.8",
|
||||
"evidence": "npm --version 与 npx --version 均输出 10.9.8；登记为同一当前工具链版本观测，不把命令入口重复计数为两件法器。",
|
||||
"resource_ids": [],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "版本观测不等于具体任务效果；分级量表阈值未校准。"
|
||||
},
|
||||
{
|
||||
"id": "dep-git-client",
|
||||
"name": "Git 本地客户端",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "3.2 文件与代码 / Git本地客户端与工作树",
|
||||
"identity_status": "runtime_observed",
|
||||
"version": "2.43.0",
|
||||
"evidence": "git --version 输出 git version 2.43.0。",
|
||||
"resource_ids": [],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "版本观测不等于具体任务效果；分级量表阈值未校准。"
|
||||
},
|
||||
{
|
||||
"id": "dep-gnu-make",
|
||||
"name": "GNU Make",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "4.3 构建系统",
|
||||
"identity_status": "runtime_observed",
|
||||
"version": "4.3",
|
||||
"evidence": "make --version 输出 GNU Make 4.3。",
|
||||
"resource_ids": [],
|
||||
"related_object_id": null,
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "版本观测不等于具体任务效果；分级量表阈值未校准。"
|
||||
},
|
||||
{
|
||||
"id": "dep-tmux-runtime",
|
||||
"name": "tmux 当前运行实例",
|
||||
"type_id": "software-artifact",
|
||||
"graph_node": "3.2 命令/终端 / tmux复用支路",
|
||||
"identity_status": "runtime_observed",
|
||||
"version": "3.4",
|
||||
"evidence": "tmux -V 输出 tmux 3.4；本次隔离 session smoke 不能证明二进制来自已登记 faqi-tmux 的固定源码修订。",
|
||||
"resource_ids": [],
|
||||
"related_object_id": "faqi-tmux",
|
||||
"grade_id": null,
|
||||
"grade_status": "pending",
|
||||
"grade_reason": "运行实例与固定源码身份尚未桥接；任务族结果带与分级量表阈值未校准。"
|
||||
}
|
||||
],
|
||||
"local_links": [
|
||||
{"object_id": "faqi-codex-config-installer", "graph_node": "2.1 Agent运行时 / Codex替代项", "relationship": "本地配置辅助脚本；不是Codex CLI实现。"},
|
||||
{"object_id": "faqi-auto-skill-create", "graph_node": "2.3 Harness与上下文 / 可选Skill制作支路", "relationship": "实现仓内Skill骨架生成入口。"},
|
||||
{"object_id": "faqi-auto-skill-validate", "graph_node": "2.3 Harness与上下文 / 可选Skill制作支路", "relationship": "实现仓内Skill结构检查入口。"},
|
||||
{"object_id": "faqi-skill-seekers-adapter", "graph_node": "2.3 Harness与上下文 / Skill Seekers适配入口", "relationship": "适配到固定submodule源码；本机依赖状态另核。"},
|
||||
{"object_id": "faqi-skill-seekers", "graph_node": "2.3 Harness与上下文 / Skill Seekers上游程序", "relationship": "固定submodule中的上游程序实现。"},
|
||||
{"object_id": "faqi-claude-skill-init", "graph_node": "2.3 Harness与上下文 / 可选Skill制作支路", "relationship": "第三方Skill集合中的独立初始化脚本，不等于Claude Code运行时。"},
|
||||
{"object_id": "faqi-auto-tmux", "graph_node": "3.2 命令/终端 / auto-tmux封装", "relationship": "依赖PATH中的tmux CLI及Shell。"},
|
||||
{"object_id": "faqi-oh-my-tmux", "graph_node": "3.2 命令/终端 / oh-my-tmux配置", "relationship": "依赖tmux与Shell的可执行配置，不是tmux本体。"},
|
||||
{"object_id": "faqi-tmux", "graph_node": "3.2 命令/终端 / tmux CLI、Server、Socket", "relationship": "固定源码内容；本地运行实例来源桥接待核。"}
|
||||
],
|
||||
"dependency_categories": [
|
||||
{"id": "dep-category-cloud-model-api", "node": "2.2 云端模型服务/API与固定模型版本", "disposition": "user_confirmed_in_scope", "reason": "用户确认此依赖类别已核并要求纳入；服务/API与模型制品仍分开登记；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。"},
|
||||
{"id": "dep-category-local-model-stack", "node": "2.2 本地模型权重、Tokenizer与推理引擎", "disposition": "user_confirmed_in_scope", "reason": "用户确认此依赖类别已核并要求纳入；模型制品、Tokenizer与推理程序分别判断；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。"},
|
||||
{"id": "dep-category-terminal-pty", "node": "3.2 Terminal Emulator / PTY", "disposition": "user_confirmed_in_scope", "reason": "用户确认此依赖类别已核并要求纳入；终端模拟器与PTY系统接口分开分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。"},
|
||||
{"id": "dep-category-package-sources", "node": "4.2 包注册表、Git源与可信缓存", "disposition": "user_confirmed_in_scope", "reason": "用户确认此依赖类别已核并要求纳入；注册表、Git来源与缓存分开分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。"},
|
||||
{"id": "dep-category-ci-platform", "node": "7.1 Git托管、CI Runner与CI/CD平台", "disposition": "user_confirmed_in_scope", "reason": "用户确认此依赖类别已核并要求纳入；托管服务、Runner执行环境与CI/CD平台分开分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。"},
|
||||
{"id": "dep-category-deployment-data", "node": "7.2-7.3 制品注册表、部署目标、产品运行时、数据库与外部API", "disposition": "user_confirmed_in_scope", "reason": "用户确认此可选依赖类别已核并要求纳入；注册表、部署环境、运行时、数据库与外部API分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。"},
|
||||
{"id": "dep-category-infrastructure", "node": "8 CPU/GPU、内存、存储、网络、电力与数据中心", "disposition": "user_confirmed_in_scope", "reason": "用户确认此资源类别已核并要求纳入；物理设备、基础设施与供给服务按所指分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。"},
|
||||
{"id": "dep-category-retrieval-memory", "node": "2.3 检索/索引/记忆与向量库", "disposition": "user_confirmed_in_scope", "reason": "用户确认此可选依赖类别已核并要求纳入；检索过程、索引、记忆内容与向量存储分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。"}
|
||||
]
|
||||
},
|
||||
"limits": {
|
||||
"independent_review": false,
|
||||
"runtime_verified": false,
|
||||
"effectiveness_verified": false,
|
||||
"license_approved": false,
|
||||
"grades_assigned": false
|
||||
"grades_assigned": true
|
||||
},
|
||||
"provisional_grade_assignments": [
|
||||
{"subject_id": "faqi-prompt-converter", "grade_id": "faqi-huang-initial", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：提示词资产格式迁移的辅助支路", "basis": "只负责格式转换，能维护和复用提示词资产但不参与模型推理或代码执行；替代方式多，属低重要性辅助。"},
|
||||
{"subject_id": "faqi-codex-config-installer", "grade_id": "faqi-xuan-initial", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：特定Agent接入配置", "basis": "降低特定Agent初始配置成本，但只服务候选运行时且可手工替代；不属于核心模型推理或执行闭环。"},
|
||||
{"subject_id": "faqi-auto-skill-create", "grade_id": "faqi-xuan-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：技能资产扩展与复用", "basis": "把操作知识封装为可复用Agent技能，能扩展后续任务能力；属于增益支路，不是最小编码闭环的必需组件。"},
|
||||
{"subject_id": "faqi-auto-skill-validate", "grade_id": "faqi-xuan-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：技能资产质量与可载入性", "basis": "降低扩展技能结构错误造成的接入阻断；不判断语义正确性，属于能力扩展的质量辅助。"},
|
||||
{"subject_id": "faqi-skill-seekers-adapter", "grade_id": "faqi-xuan-initial", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：Skill Seekers本地适配入口", "basis": "便于调用特定知识转技能工具；范围受上游工具限制，可直接调用或人工替代。"},
|
||||
{"subject_id": "faqi-skill-seekers", "grade_id": "faqi-xuan-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：外部知识转可复用技能", "basis": "增加Agent可复用的领域能力和上下文资产；需特定工作流，不能替代通用推理与工具执行。"},
|
||||
{"subject_id": "faqi-auto-tmux", "grade_id": "faqi-huang-advanced", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：多会话终端协作自动化", "basis": "能管理多会话和worker工作流，复杂并行时有用；基础单Agent编码不依赖，且当前doctor烟测失败，重要性不等于实现质量。"},
|
||||
{"subject_id": "faqi-oh-my-tmux", "grade_id": "faqi-huang-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：终端复用器体验配置", "basis": "改善tmux使用便利性，但不提供模型推理或核心代码执行能力，可由其他终端配置替代。"},
|
||||
{"subject_id": "faqi-tmux", "grade_id": "faqi-huang-advanced", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：可选的多会话终端复用", "basis": "支持持久终端与多窗口工作流，复杂长任务可受益；普通编码闭环有替代方案，不属定义性核心。"},
|
||||
{"subject_id": "faqi-claude-skill-init", "grade_id": "faqi-xuan-initial", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：特定Skill模板初始化", "basis": "降低Claude Skill结构初始化成本，作用范围绑定特定生态，可手工完成且不影响其他Agent的基础闭环。"},
|
||||
{"subject_id": "dep-pi-cli", "grade_id": "faqi-tian-advanced", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：当前核心Agent运行与工具编排", "basis": "直接承接需求、上下文、模型调用和工具执行循环；当前环境的核心交互入口，缺失会改变Vibe Coding核心形态。"},
|
||||
{"subject_id": "dep-codex-cli", "grade_id": "faqi-tian-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：替代Agent运行时", "basis": "若选用可承担AI代码协作与工具编排核心；当前仅具名候选且可与其他运行时替换，低于已用核心路径。"},
|
||||
{"subject_id": "dep-claude-code", "grade_id": "faqi-tian-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：替代Agent运行时", "basis": "若选用可承担AI代码协作与工具编排核心；当前仅具名候选且可与其他运行时替换，低于已用核心路径。"},
|
||||
{"subject_id": "dep-wsl2-platform", "grade_id": "faqi-di-initial", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：当前宿主环境实现", "basis": "为当前工具链提供运行宿主，但Linux、macOS或原生Windows等环境可替代，不是Vibe Coding定义性能力。"},
|
||||
{"subject_id": "dep-ubuntu-userland", "grade_id": "faqi-di-initial", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：当前Linux用户空间", "basis": "承载当前工具链和本地命令，但同类操作系统环境可以替代，重要性来自运行基座而非该发行版身份。"},
|
||||
{"subject_id": "dep-wsl2-kernel", "grade_id": "faqi-di-initial", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：当前运行环境内核", "basis": "提供当前WSL用户空间的执行底座，但存在其他内核和宿主替代，不属于AI编程核心能力。"},
|
||||
{"subject_id": "dep-bash", "grade_id": "faqi-di-advanced", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：Agent命令执行与脚本交互", "basis": "直接承接终端命令、开发脚本和验证操作，是当前Agent落地代码动作的高重要性接口；Shell实现可替代但该角色不可缺。"},
|
||||
{"subject_id": "dep-python-runtime", "grade_id": "faqi-di-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：脚本、工具与项目代码运行", "basis": "支撑本仓工具及大量Python项目的执行和验证；语言运行时可按项目替代，重要但非所有Vibe Coding任务必需。"},
|
||||
{"subject_id": "dep-nodejs-runtime", "grade_id": "faqi-di-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：前端及工具链代码运行", "basis": "支撑前端、Node项目和本仓Markdown工具链；具体语言环境可替代，重要性低于通用Agent与终端执行核心。"},
|
||||
{"subject_id": "dep-npm-npx", "grade_id": "faqi-di-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：Node依赖解析与工具调用", "basis": "让Node生态依赖和命令行工具可安装、解析与调用；作用范围依赖项目技术栈，可由其他生态包管理器替代。"},
|
||||
{"subject_id": "dep-git-client", "grade_id": "faqi-di-advanced", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：代码变更追踪、比较与恢复", "basis": "支撑审查AI改动、保留版本历史和安全回退，是可维护代码生成闭环的高重要性基础；版本控制实现可替代。"},
|
||||
{"subject_id": "dep-gnu-make", "grade_id": "faqi-di-initial", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：可重复构建与检查入口", "basis": "把构建和验证命令组织成可重复入口有助于交付，但Make可由其他任务运行器或脚本替代。"},
|
||||
{"subject_id": "dep-tmux-runtime", "grade_id": "faqi-huang-advanced", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：长任务与多会话终端复用", "basis": "可持久化和并行组织终端工作，复杂协作时有价值；普通单会话开发可替代，不属于核心生成链。"},
|
||||
{"subject_id": "dep-category-cloud-model-api", "grade_id": "faqi-tian-advanced", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：核心模型推理与代码生成", "basis": "提供理解需求、推理和生成代码的核心智能能力；没有模型推理路径即失去Vibe Coding的定义性特征，供应商与模型可替换。"},
|
||||
{"subject_id": "dep-category-local-model-stack", "grade_id": "faqi-tian-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：本地/离线模型推理路径", "basis": "可提供核心模型推理并支持本地化、隐私或离线需求；在通用工作流中可由云端推理替代，故低于定义性核心路径。"},
|
||||
{"subject_id": "dep-category-terminal-pty", "grade_id": "faqi-di-advanced", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：Agent调用工具与执行开发命令", "basis": "把Agent计划转成真实文件、构建和测试操作的关键执行边界；没有等价工具执行通道，代码闭环无法完成。"},
|
||||
{"subject_id": "dep-category-package-sources", "grade_id": "faqi-di-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：依赖获取、锁定与复现", "basis": "支持安装成熟组件、解析代码依赖和重建开发环境；具体注册表与来源有替代，不直接承担AI生成。"},
|
||||
{"subject_id": "dep-category-ci-platform", "grade_id": "faqi-xuan-advanced", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：自动化验证、协作与持续交付", "basis": "把代码生成接入可重复测试、审查和协作交付，显著扩展可靠使用范围；本地闭环可运行但难以替代团队级持续验证。"},
|
||||
{"subject_id": "dep-category-deployment-data", "grade_id": "faqi-xuan-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：从代码到产品运行与外部集成", "basis": "支撑部署、数据库和API集成，使代码进入真实产品场景；并非每次编码必需，故属于重要交付扩展而非核心生成。"},
|
||||
{"subject_id": "dep-category-infrastructure", "grade_id": "faqi-di-intermediate", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：计算、存储与网络承载", "basis": "为模型调用、代码执行及数据交换提供资源底座；实现可跨云、主机和本地环境替换，故不是单一核心产品。"},
|
||||
{"subject_id": "dep-category-retrieval-memory", "grade_id": "faqi-xuan-advanced", "assignment_status": "user_directed_provisional", "scope": "Vibe Coding重要性：长程上下文、知识检索与记忆", "basis": "支撑跨文件和长任务上下文保持、历史知识复用，提升复杂任务可处理范围；短任务仍可不依赖，且实现可替换。"}
|
||||
],
|
||||
"sources": [
|
||||
{
|
||||
"id": "S01",
|
||||
|
||||
@@ -1,24 +1,26 @@
|
||||
{
|
||||
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||
"title": "法器来源限定初审与资源分流",
|
||||
"description": "只引用唯一BFO树。记录程序内容而非运行/效果/许可批准；外部条目ID引用原YAML，不复制资源事实。",
|
||||
"title": "Vibe Coding法器总分类与重要性分级登记",
|
||||
"description": "复用唯一BFO树，汇总来源限定实现、依赖图对象、用户确认纳入类别及按Vibe Coding重要性排序的用户授权暂定品级。重要性分级不代表效能验证或正式效能评级；外部资源ID引用原YAML。",
|
||||
"type": "object",
|
||||
"additionalProperties": false,
|
||||
"required": ["format_version", "kind", "reviewed_at", "source_revision", "ontology", "limits", "sources", "objects", "local_entries", "local_exclusions", "external_sources", "external_reviews", "resource_notes", "local_resource_links", "relations", "references"],
|
||||
"required": ["format_version", "kind", "reviewed_at", "source_revision", "ontology", "dependency_graph", "limits", "provisional_grade_assignments", "sources", "objects", "local_entries", "local_exclusions", "external_sources", "external_reviews", "resource_notes", "local_resource_links", "relations", "references"],
|
||||
"properties": {
|
||||
"format_version": {"const": 1},
|
||||
"kind": {"const": "faqi-initial-source-review"},
|
||||
"format_version": {"const": 2},
|
||||
"kind": {"const": "faqi-master-classification-register"},
|
||||
"reviewed_at": {"type": "string", "maxLength": 40},
|
||||
"source_revision": {"$ref": "#/$defs/revision"},
|
||||
"ontology": {
|
||||
"type": "object", "additionalProperties": false, "required": ["path", "sha256"],
|
||||
"properties": {"path": {"const": "docs/gongfa/cultivation-ontology-taxonomy.md"}, "sha256": {"$ref": "#/$defs/sha256"}}
|
||||
},
|
||||
"dependency_graph": {"$ref": "#/$defs/dependency_graph"},
|
||||
"limits": {
|
||||
"type": "object", "additionalProperties": false,
|
||||
"required": ["independent_review", "runtime_verified", "effectiveness_verified", "license_approved", "grades_assigned"],
|
||||
"properties": {"independent_review": {"const": false}, "runtime_verified": {"const": false}, "effectiveness_verified": {"const": false}, "license_approved": {"const": false}, "grades_assigned": {"const": false}}
|
||||
"properties": {"independent_review": {"const": false}, "runtime_verified": {"const": false}, "effectiveness_verified": {"const": false}, "license_approved": {"const": false}, "grades_assigned": {"const": true, "description": "有用户授权的Vibe Coding重要性暂定分级；不代表正式效能评级。"}}
|
||||
},
|
||||
"provisional_grade_assignments": {"type": "array", "minItems": 1, "maxItems": 1024, "items": {"$ref": "#/$defs/provisional_grade_assignment"}},
|
||||
"sources": {"type": "array", "minItems": 1, "maxItems": 128, "items": {"$ref": "#/$defs/source"}},
|
||||
"objects": {"type": "array", "minItems": 1, "maxItems": 512, "items": {"$ref": "#/$defs/tool"}},
|
||||
"local_entries": {"type": "array", "minItems": 1, "maxItems": 128, "items": {"$ref": "#/$defs/local"}},
|
||||
@@ -74,6 +76,67 @@
|
||||
"selection_sha256": {"$ref": "#/$defs/sha256"}
|
||||
}
|
||||
},
|
||||
"dependency_graph": {
|
||||
"type": "object", "additionalProperties": false,
|
||||
"required": ["source_path", "source_sha256", "source_anchor", "observed_at", "user_confirmation", "objects", "local_links", "dependency_categories"],
|
||||
"properties": {
|
||||
"source_path": {"const": "docs/gongfa/technology-stack.md"},
|
||||
"source_sha256": {"$ref": "#/$defs/sha256"},
|
||||
"source_anchor": {"const": "reference-technology-stack-十六技术栈的层级结构"},
|
||||
"observed_at": {"type": "string", "maxLength": 40, "pattern": "^\\d{4}-\\d{2}-\\d{2}T[^\\u0000-\\u001f]+Z$"},
|
||||
"user_confirmation": {
|
||||
"type": "object", "additionalProperties": false, "required": ["reviewed_at", "statement", "scope"],
|
||||
"properties": {
|
||||
"reviewed_at": {"type": "string", "maxLength": 40, "pattern": "^\\d{4}-\\d{2}-\\d{2}T[^\\u0000-\\u001f]+Z$"},
|
||||
"statement": {"$ref": "#/$defs/text"}, "scope": {"$ref": "#/$defs/text"}
|
||||
}
|
||||
},
|
||||
"objects": {"type": "array", "minItems": 12, "maxItems": 64, "items": {"$ref": "#/$defs/dependency_object"}},
|
||||
"local_links": {"type": "array", "minItems": 1, "maxItems": 64, "items": {"$ref": "#/$defs/graph_local_link"}},
|
||||
"dependency_categories": {"type": "array", "minItems": 1, "maxItems": 64, "items": {"$ref": "#/$defs/graph_dependency_category"}}
|
||||
}
|
||||
},
|
||||
"dependency_object": {
|
||||
"type": "object", "additionalProperties": false,
|
||||
"required": ["id", "name", "type_id", "graph_node", "identity_status", "version", "evidence", "resource_ids", "related_object_id", "grade_id", "grade_status", "grade_reason"],
|
||||
"properties": {
|
||||
"id": {"$ref": "#/$defs/id"}, "name": {"$ref": "#/$defs/text"},
|
||||
"type_id": {"type": "string", "pattern": "^[a-z][a-z0-9-]{0,63}$"},
|
||||
"graph_node": {"$ref": "#/$defs/text"},
|
||||
"identity_status": {"enum": ["runtime_observed", "named_candidate"]},
|
||||
"version": {"type": ["string", "null"], "maxLength": 120},
|
||||
"evidence": {"$ref": "#/$defs/text"}, "resource_ids": {"type": "array", "maxItems": 8, "uniqueItems": true, "items": {"$ref": "#/$defs/id"}},
|
||||
"related_object_id": {"type": ["string", "null"]},
|
||||
"grade_id": {"const": null}, "grade_status": {"const": "pending"},
|
||||
"grade_reason": {"$ref": "#/$defs/text"}
|
||||
}
|
||||
},
|
||||
"graph_local_link": {
|
||||
"type": "object", "additionalProperties": false,
|
||||
"required": ["object_id", "graph_node", "relationship"],
|
||||
"properties": {"object_id": {"$ref": "#/$defs/id"}, "graph_node": {"$ref": "#/$defs/text"}, "relationship": {"$ref": "#/$defs/text"}}
|
||||
},
|
||||
"graph_dependency_category": {
|
||||
"type": "object", "additionalProperties": false,
|
||||
"required": ["id", "node", "disposition", "reason"],
|
||||
"properties": {
|
||||
"id": {"$ref": "#/$defs/id"},
|
||||
"node": {"$ref": "#/$defs/text"},
|
||||
"disposition": {"enum": ["pending_identity", "unselected_optional", "user_confirmed_in_scope", "not_faqi"]},
|
||||
"reason": {"$ref": "#/$defs/text"}
|
||||
}
|
||||
},
|
||||
"provisional_grade_assignment": {
|
||||
"type": "object", "additionalProperties": false,
|
||||
"required": ["subject_id", "grade_id", "assignment_status", "scope", "basis"],
|
||||
"properties": {
|
||||
"subject_id": {"$ref": "#/$defs/id"},
|
||||
"grade_id": {"type": "string", "pattern": "^faqi-(huang|xuan|di|tian)-[a-z0-9-]+$", "description": "本清单按用户指定的Vibe Coding重要性顺序暂定分级，不是效能等级。"},
|
||||
"assignment_status": {"enum": ["task_scoped_provisional", "user_directed_provisional"]},
|
||||
"scope": {"$ref": "#/$defs/text"},
|
||||
"basis": {"$ref": "#/$defs/text"}
|
||||
}
|
||||
},
|
||||
"tool": {
|
||||
"type": "object", "additionalProperties": false, "required": ["id", "name", "type_id", "implementation", "support", "boundary", "declared_version"],
|
||||
"properties": {
|
||||
|
||||
@@ -17,6 +17,9 @@ terms:
|
||||
quality-gate:
|
||||
zh: 质量门禁
|
||||
description: 测试、CI、脚本、类型、schema 或检查清单等可强制验证的约束。
|
||||
faqi:
|
||||
zh: 法器
|
||||
description: Vibe Coding 中被选作任务能力载体的工具、可调用入口或依赖类别；具体身份、角色与效果需分别核实。
|
||||
pinhaoma:
|
||||
zh: 拼好码
|
||||
description: 胶水编程的超集，强调优先复用成熟方案，用自研代码连接、编排、适配和表达业务逻辑。
|
||||
|
||||
@@ -4,8 +4,8 @@
|
||||
|
||||
- 全部已分类功法看同一张[功法总表](catalog.md)／[Excel完整视图](catalog.xlsx)，数量和覆盖由仓内生成器维护。
|
||||
- [registry.json](registry.json)仍是活跃登记唯一可编辑数据源；候选历史材料是不可变来源快照，不自动入库。
|
||||
- 2026-10-07的两次入库轮次共79条：仓内62条＋指定项目页面17条；续收21条，原58条及旧意见保持。
|
||||
- 这两批入库初评为黄7、玄47、地25、天0；不是跨候选总表数量，不是效果实测。
|
||||
- 2026-10-07的两次入库轮次共79条：仓内62条＋指定项目页面17条；另续收21条。拼好码于2026-10-11按用户指令由地阶中级暂定调整为天阶高级暂定，历史值与理由见文件末尾审计。
|
||||
- 两批入库初评的原始分布为黄7、玄47、地25、天0；这是修订前历史记录，不代表当前分布，也不是效果实测。
|
||||
- 完整可复用正文从[统一功法文集](../../docs/gongfa/README.md)进入；文集不等于独立功法记录。
|
||||
- [本体主文](../../docs/gongfa/cultivation-ontology-taxonomy.md#功法本体与品级)解释类型与语义；等级是分组，不是类型继承。
|
||||
- 来源声明、编者摘要与真实效果证据不同；缺失字段明确列在`missing_fields`，不编造成立条件或效果。
|
||||
@@ -245,3 +245,5 @@ python3 scripts/check-gongfa.py --render-catalog --proposal-batch gongfa-author-
|
||||
|
||||
2026-10-08：将此前全部已分类内容的总表移入项目，保留当前登记与三批候选来源的旧意见；新增离线生成/检查和行为测试。
|
||||
同一总表提供Markdown及Excel呈现，不把候选自动注册，不重评、不修改原文，不依赖临时目录。
|
||||
|
||||
<!-- 用户授权审计：门禁=metadata/gongfa/AGENTS.md#修改契约-7（初评更正应追加批次并保留旧意见）；用户原话摘要=“先处理功法，要求把拼好码提升到天阶上品（与组块理论相关）”；时间=2026-10-11T04:46:33Z；范围=仅gongfa-glue-coding@r1暂定初评；旧值=di-intermediate，旧理由=预计在陌生领域和维护要求较高的任务中减少重复自研并保留替换回滚；并非复用越多越强；旧反证=供应链或依赖锁定风险不可控、接口无法隔离，或关键约束超出候选能力；结果=就地改为tian-advanced（项目词表的天阶高级/最高细级），把组块理论列为结构类比与待验证机制假设；confidence=low，未创建正式assessment，不改规约、原文或其他条目；绕过=仅初评更正的追加批次流程。 -->
|
||||
|
||||
+11
-11
@@ -9,22 +9,22 @@
|
||||
- 同一总表的[Excel完整视图](catalog.xlsx)含限定原文/源条目、来源选区、边界、理由、反证和置信。
|
||||
- 活跃登记来自[registry.json](registry.json)，历史候选来自[仓内快照索引](catalog-sources.json)；维护边界见[README](README.md)。
|
||||
|
||||
输入绑定：`f78e799ed13956b958831310efb201cfd7b2339d6863e40b02139211bba7faf2`。
|
||||
输入绑定：`07ed857bb608571059c2a4b90695d99143bb657b5e9971a6351a97b548ba9a66`。
|
||||
|
||||
## 全部记录
|
||||
|
||||
| 序号 | 暂定品级 | 功法名称 | 本体类别 | 登记状态 | 来源批次 | 用途/任务族 | 原始ID / 版本 |
|
||||
|---|---|---|---|---|---|---|---|
|
||||
| 1 | 地高 | 第一性原理 | 方法型 | 已登记 | 原登记库 | 错误前提下的问题重构与方案重推 | gongfa-first-principles / r1 |
|
||||
| 2 | 地高 | 形式化方法（轻量形式化） | 方法型 | 已登记 | 原登记库 | 协议、不变量与边界条件检查 | gongfa-lightweight-formal-methods / r1 |
|
||||
| 3 | 地高 | 方法论工具箱总体作业流 | 方法型 | 已登记 | 原登记库 | 从需求澄清到交付验证的整体作业 | gongfa-methodology-delivery-loop / r1 |
|
||||
| 4 | 地中 | 胶水原则 | 准则型 | 已登记 | 原登记库 | 技术选型与成熟能力复用 | gongfa-glue-principle / r1 |
|
||||
| 5 | 地中 | 反事实推理（Counterfactuals） | 方法型 | 已登记 | 原登记库 | 因果解释与验证器的反事实检查 | gongfa-counterfactual-testing / r1 |
|
||||
| 6 | 地中 | 溯因排错法（仓内操作版） | 方法型 | 已登记 | 原登记库 | 多候选原因的故障诊断 | gongfa-abductive-debugging / r1 |
|
||||
| 7 | 地中 | 错误认识论（Error epistemology） | 方法型 | 已登记 | 原登记库 | 高风险方案的失败模式与防护分析 | gongfa-failure-mode-analysis / r1 |
|
||||
| 8 | 地中 | 实验哲学（x-phi） | 方法型 | 已登记 | 原登记库 | 可区分假设的工程实验设计 | gongfa-experimental-design / r1 |
|
||||
| 9 | 地中 | 固定点收敛系统 | 方法型 | 已登记 | 原登记库 | 自治任务执行的分层验证与升级 | gongfa-fixed-point-convergence / r1 |
|
||||
| 10 | 地中 | 拼好码 | 复合（保留上位） | 已登记 | 原登记库 | 复用主导的软件系统组装与演化 | gongfa-glue-coding / r1 |
|
||||
| 1 | 天高 | 拼好码 | 复合（保留上位） | 已登记 | 原登记库 | 复用主导的软件系统组装与演化 | gongfa-glue-coding / r1 |
|
||||
| 2 | 地高 | 第一性原理 | 方法型 | 已登记 | 原登记库 | 错误前提下的问题重构与方案重推 | gongfa-first-principles / r1 |
|
||||
| 3 | 地高 | 形式化方法（轻量形式化） | 方法型 | 已登记 | 原登记库 | 协议、不变量与边界条件检查 | gongfa-lightweight-formal-methods / r1 |
|
||||
| 4 | 地高 | 方法论工具箱总体作业流 | 方法型 | 已登记 | 原登记库 | 从需求澄清到交付验证的整体作业 | gongfa-methodology-delivery-loop / r1 |
|
||||
| 5 | 地中 | 胶水原则 | 准则型 | 已登记 | 原登记库 | 技术选型与成熟能力复用 | gongfa-glue-principle / r1 |
|
||||
| 6 | 地中 | 反事实推理（Counterfactuals） | 方法型 | 已登记 | 原登记库 | 因果解释与验证器的反事实检查 | gongfa-counterfactual-testing / r1 |
|
||||
| 7 | 地中 | 溯因排错法（仓内操作版） | 方法型 | 已登记 | 原登记库 | 多候选原因的故障诊断 | gongfa-abductive-debugging / r1 |
|
||||
| 8 | 地中 | 错误认识论（Error epistemology） | 方法型 | 已登记 | 原登记库 | 高风险方案的失败模式与防护分析 | gongfa-failure-mode-analysis / r1 |
|
||||
| 9 | 地中 | 实验哲学（x-phi） | 方法型 | 已登记 | 原登记库 | 可区分假设的工程实验设计 | gongfa-experimental-design / r1 |
|
||||
| 10 | 地中 | 固定点收敛系统 | 方法型 | 已登记 | 原登记库 | 自治任务执行的分层验证与升级 | gongfa-fixed-point-convergence / r1 |
|
||||
| 11 | 地中 | 最小先验条件下的代理增强型任务求解 | 方法型 | 已登记 | 原登记库 | 陌生领域的受控代理增强交付 | gongfa-minimal-prior-agent-assisted-solving / r1 |
|
||||
| 12 | 地中 | 问题界定与求解闭环（仓内体系版） | 方法型 | 已登记 | 原登记库 | 复杂需求的问题界定与求解闭环 | gongfa-problem-definition-framework / r1 |
|
||||
| 13 | 地中 | 6.2 契约式设计 | 方法型 | 未入登记库 | 此前四HTML | 跨模块责任与不变式约束 | A088 / 冻结选区；未设登记版本 |
|
||||
|
||||
Binary file not shown.
@@ -3617,7 +3617,7 @@
|
||||
"类型不决定档位。按0.1.0的黄/玄/地/天方向预估限定任务效果、合理基线增益、困难/迁移表现和能力缺口；未借标题、字数、步骤数、名气、抽象性或形式化程度打分。",
|
||||
"初/中/高表示本阶预计结果带而非置信度、次数或等距倍率；区间尚未校准，不能跨任务、跨类型直接排名。",
|
||||
"confidence只是作者对前瞻判断的主观把握标签，不是准确率、概率或实测可靠性；所有效果条件都还需要受控验证。",
|
||||
"未给天阶建议：本批材料不足以让我预期能在合理基线之外突破已明确的能力缺口；不为填满词表而硬赋高阶。",
|
||||
"拼好码按2026-10-11用户指令修订为天阶高级暂定；组块理论关联仅作结构类比和机制假设，不构成效能证据；其余条目意见及未校准范围保持不变。",
|
||||
"每条falsifier指出可推翻或下调初评的条件，不是已经执行的实验或失败记录。内容版本变更不自动继承本批意见；正式评级仍另追加assessments。"
|
||||
],
|
||||
"supersedes": null,
|
||||
@@ -4035,12 +4035,12 @@
|
||||
"content_version": "r1",
|
||||
"content_sha256": "7ee9dc827a5bceca480aa7d2b969cfd49a097b4791acb970c7e47ede82393c9c",
|
||||
"ontology_type": "dao-content",
|
||||
"grade_id": "di-intermediate",
|
||||
"grade_id": "tian-advanced",
|
||||
"task_family": "复用主导的软件系统组装与演化",
|
||||
"classification_reason": "条目把复用价值准则、工程机制及需求到验证的流程作为完整范式表达。",
|
||||
"reason": "预计在陌生领域和维护要求较高的任务中减少重复自研并保留替换回滚；并非复用越多越强。",
|
||||
"confidence": "medium",
|
||||
"falsifier": "若供应链或依赖锁定风险不可控、接口无法隔离，或关键约束超出候选能力，应下调。"
|
||||
"reason": "用户要求将拼好码提升至天阶上品，按项目词表映射为天阶高级（tian-advanced）。与组块理论的关联作为结构类比：把成熟能力组织为可识别、可复用、可组合的单元，再由拼好码完成需求匹配、边界适配和编排，可能使复杂问题的处理转向更高层次的系统组合与业务表达。该机制假设支持用户指定的最高档暂定判断，但并非受控任务结果，尚未证明相对固定合理基线突破了明确能力缺口。",
|
||||
"confidence": "low",
|
||||
"falsifier": "若预先固定的组块化软件组合任务中，相比合理基线未达到预定正确性、可靠性、成本与可维护性阈值，或组件边界/接口错配、供应链与依赖风险抵消收益，则应下调；若组块化并未带来可重复的高层组合优势，该机制假设亦被推翻。"
|
||||
},
|
||||
{
|
||||
"gongfa_id": "gongfa-attractor-model",
|
||||
|
||||
+10
-1
@@ -6,7 +6,7 @@ sections:
|
||||
agent_guide: docs/getting-started/AGENTS.md
|
||||
gongfa:
|
||||
path: docs/gongfa
|
||||
purpose: 方法论、哲学、思维模型、准则、流程及配套文集的唯一正文源
|
||||
purpose: 方法论、哲学、思维模型、准则、流程及本体/法器配套说明的唯一正文源
|
||||
entry: docs/gongfa/README.md
|
||||
agent_guide: docs/gongfa/AGENTS.md
|
||||
research:
|
||||
@@ -58,7 +58,13 @@ reading_paths:
|
||||
- docs/gongfa/project-architecture-template.md
|
||||
- docs/gongfa/quality-gates-and-pitfalls.md
|
||||
- assets/ai-citation/README.md
|
||||
faqi:
|
||||
title: 法器体系阅读路径
|
||||
documents:
|
||||
- docs/gongfa/faqi-system.md
|
||||
- docs/gongfa/cultivation-ontology-taxonomy.md
|
||||
selection_rules:
|
||||
faqi: 需要理解 Vibe Coding 工具/依赖分类、重要性分级或效能边界时，读法器体系说明，再核生成总表与登记事实。
|
||||
gongfa: 需要认知模型、问题求解、工程准则、架构模板、方法、流程、门禁或研究转化时统一读取；文集与独立功法记录分开。
|
||||
research: 需要具体对象的原始事实、观察、风险和验证记录时读取，不另建方法正文副本。
|
||||
getting-started: 需要配置网络、AI CLI、开发环境并完成最小实例闭环时读取；通用经验链接到功法。
|
||||
@@ -89,6 +95,9 @@ documents:
|
||||
- path: docs/gongfa/vibe-coding-cultivation-model.md
|
||||
title: 修仙解释图层
|
||||
role: BFO 下层展开的通俗解释；区分模型、会话、方法、工具、资源与任务评价
|
||||
- path: docs/gongfa/faqi-system.md
|
||||
title: 法器体系说明
|
||||
role: 工具与依赖分类边界、Vibe Coding重要性分级、选用方式及正式效能评级边界
|
||||
- path: docs/gongfa/cultivation-ontology-taxonomy.md
|
||||
title: 修仙领域统一本体与分类设计（V4 BFO 草案）
|
||||
role: 固定 BFO 主干、唯一分类树、领域稳定 ID、实体/品质及规约/方法/过程细分类、制备、观测及再生证据链、分层身份与组成判据；功法收录/内容版本及四阶十二级接入JSON核心，限定内容可追溯、已有人工分类/初评、规约未校准且无正式效果评级，当前收录范围见子域入口；不扩展全仓本体
|
||||
|
||||
+3
-3
@@ -32,10 +32,10 @@
|
||||
- `test-gongfa-catalog.py`保留输入、命令/日志和结果；检查来源绑定/表示一致性，不证明效果或独立语义批准。
|
||||
- 注册库仍唯一拥有活跃登记/正式评级；候选历史快照只作来源事实，迁移入库后才考虑退役该来源视图。
|
||||
|
||||
## 法器初审维护
|
||||
## 法器总分类维护
|
||||
|
||||
- `sync-faqi-catalog.py`复用jsonschema/PyYAML/tabulate，读取初审JSON与原资源YAML，只维护`tools/faqi-catalog.md`；不自动分类、联网、执行工具或写原登记。
|
||||
- 字段、来源用途、入口/身份与输出边界变化先补真实行为测试；初审不是独立语义、许可证、部署/运行或效果证明，不套功法品级。
|
||||
- `sync-faqi-catalog.py`复用jsonschema/PyYAML/tabulate，读取总分类JSON、固定来源与外部资源YAML，校验依赖图SHA及对象映射，只维护`tools/faqi-catalog.md`；不联网、执行工具或写回被审源码。
|
||||
- 字段、来源用途、入口/身份与输出边界变化先补真实行为测试；源审、运行实例观测与效果评级分开。未校准时不得写正式等级；仅在审计记录的显式用户授权下，`provisional_grade_assignments`可写可撤销暂定分组，并须声明不代表效能验证。
|
||||
- 用户范围排除保留独立证据与重审条件，不进入`objects`；同一入口可对应多条以名称区分的排除记录，各自绑定唯一`exclusion_evidence`来源；空入口不能清空排除后静默复入。
|
||||
- 固定Git/submodule修订、完整字节SHA与一基半开选区；来源/输入/输出软链接、未知字段、漏/重资源、越界/超限与并行漂移非零失败。
|
||||
- 生成标记、输入/目标前后复核与单文件原子替换只保护本工具输出，不声称多文件事务或跨写者强CAS；失败保留工件，不清理别人文件。
|
||||
|
||||
+108
-16
@@ -1,5 +1,5 @@
|
||||
#!/usr/bin/env python3
|
||||
"""校验来源限定的法器初审，生成单一只读视图；不推断类别或执行被审工具。"""
|
||||
"""校验法器总分类登记与依赖图观察，生成只读视图；不执行被审工具或推断等级。"""
|
||||
import argparse
|
||||
import configparser
|
||||
import datetime
|
||||
@@ -30,6 +30,13 @@ DECISIONS = {
|
||||
"related_local_source": "关联已审本地来源",
|
||||
"restricted_service_pending": "待核：受限服务所指",
|
||||
}
|
||||
GRADE_TIERS = (("tian", "天阶"), ("di", "地阶"), ("xuan", "玄阶"), ("huang", "黄阶"))
|
||||
GRADE_LEVELS = (("initial", "初级"), ("intermediate", "中级"), ("advanced", "高级"))
|
||||
GRADE_LABELS = {
|
||||
f"faqi-{tier}-{level}": f"{tier_label}{level_label}"
|
||||
for tier, tier_label in (("tian", "天阶"), ("di", "地阶"), ("xuan", "玄阶"), ("huang", "黄阶"))
|
||||
for level, level_label in GRADE_LEVELS
|
||||
}
|
||||
|
||||
|
||||
class ContractError(Exception):
|
||||
@@ -140,6 +147,15 @@ def validate(root, input_path):
|
||||
bindings[ontology_path] = digest(ontology_raw)
|
||||
ontology = ontology_raw.decode("utf-8")
|
||||
type_ids = set(re.findall(r"^\| `([^`]+)` \|", ontology, re.MULTILINE))
|
||||
graph = data["dependency_graph"]
|
||||
graph_path = safe_path(root, graph["source_path"])
|
||||
graph_raw = bounded_read(graph_path)
|
||||
require(digest(graph_raw) == graph["source_sha256"], "依赖图来源SHA漂移，需重新核实对象映射")
|
||||
graph_text = graph_raw.decode("utf-8")
|
||||
require(f'<a id="{graph["source_anchor"]}"></a>' in graph_text, "依赖图锚点不存在")
|
||||
graph_time = datetime.datetime.fromisoformat(graph["observed_at"].replace("Z", "+00:00"))
|
||||
require(graph_time.tzinfo is not None, "依赖图观测时间须含时区")
|
||||
bindings[graph_path] = digest(graph_raw)
|
||||
sources = indexed(data["sources"], "id", "来源ID")
|
||||
objects = indexed(data["objects"], "id", "法器实现ID")
|
||||
footprints = set()
|
||||
@@ -231,6 +247,23 @@ def validate(root, input_path):
|
||||
require(set(data["resource_notes"]) <= resources.keys(), "附注引用未知资源")
|
||||
related = {rid for rid, review in decisions.items() if review["decision"] == "related_local_source"}
|
||||
require(data["local_resource_links"].keys() == related, "本地来源关联缺失或范围扩大")
|
||||
graph_objects = indexed(data["dependency_graph"]["objects"], "id", "依赖图对象ID")
|
||||
require(not (graph_objects.keys() & objects.keys()), "依赖图对象与本地来源对象ID冲突；不得复制同一身份")
|
||||
for obj in graph_objects.values():
|
||||
require(obj["type_id"] in type_ids, "依赖图对象引用了不存在的本体类")
|
||||
require(obj["related_object_id"] is None or obj["related_object_id"] in objects, "依赖图运行实例关联未知本地对象")
|
||||
require(set(obj["resource_ids"]) <= resources.keys(), "依赖图对象引用未知外部资源ID")
|
||||
require(obj["grade_id"] is None and obj["grade_status"] == "pending", "草案量表未校准，不得登记法器等级")
|
||||
graph_links = indexed(data["dependency_graph"]["local_links"], "object_id", "依赖图本地关联对象")
|
||||
require(graph_links.keys() <= objects.keys(), "依赖图关联引用未知本地来源对象")
|
||||
graph_categories = indexed(data["dependency_graph"]["dependency_categories"], "node", "依赖图类别")
|
||||
require(all(item["disposition"] == "user_confirmed_in_scope" for item in graph_categories.values()),
|
||||
"用户已确认纳入的依赖类别不得降级为范围外或遗漏")
|
||||
category_ids = {item["id"] for item in graph_categories.values()}
|
||||
grade_assignments = indexed(data["provisional_grade_assignments"], "subject_id", "暂定品级记录")
|
||||
expected_grade_subjects = set(objects) | set(graph_objects) | category_ids
|
||||
require(grade_assignments.keys() == expected_grade_subjects, "暂定品级记录必须完整覆盖本次纳入对象，不能遗漏或增加条目")
|
||||
require(all(item["grade_id"] in GRADE_LABELS for item in grade_assignments.values()), "暂定品级ID不在法器四阶十二级词表中")
|
||||
modules_path = safe_path(root, ".gitmodules")
|
||||
module_bytes = bounded_read(modules_path)
|
||||
require(module_bytes == git_blob(root, data["source_revision"], ".gitmodules"), "submodule注册文件漂移")
|
||||
@@ -287,20 +320,76 @@ def table(rows, headers):
|
||||
|
||||
|
||||
def render(data, sources, objects, resources, decisions):
|
||||
out = [MARKER, "# 法器清单与资源初审", "",
|
||||
"来源限定的静态初审，不是效果、可用性、许可证或独立语义批准。仅修改[法器初审数据](../metadata/faqi.json)，不手改此视图。",
|
||||
"类型与关系复用[唯一本体](../docs/gongfa/cultivation-ontology-taxonomy.md#唯一分类树)，不维护第二主树，不套功法四阶十二级。", "",
|
||||
"## 总体概览", "", f"初审时间：{data['reviewed_at']}；父仓库来源修订：`{data['source_revision']}`。",
|
||||
f"本地入口 {len(data['local_entries'])} 个，来源限定法器实现初审 {len(objects)} 条，另有 {len(data['local_exclusions'])} 条明确范围排除；外部资源逐行分流 {len(resources)} 条。不是按目录或资源行计算独立产品数。",
|
||||
"程序源码修订和下表声明版本不等于已核发布版、已安装版本或已部署入口；同内容副本、多入口不重复登记。", "",
|
||||
table([[DECISIONS[r['decision']], len(r['resource_ids'])] for r in data['external_reviews']], ["外部分流状态", "资源行数"]),
|
||||
"## 本地来源限定法器", "",
|
||||
"以下记录只指选定来源的程序指令内容；不同内容实现是否属于同一产品/派生版本，仍须另有演化证据。用途不作为主父。", "",
|
||||
table([[o['id'], o['name'], o['type_id'], o['implementation']] for o in objects.values()], ["实现ID", "名称", "已有类型ID", "实现来源ID"])]
|
||||
graph = data["dependency_graph"]
|
||||
graph_links = {item["object_id"]: item for item in graph["local_links"]}
|
||||
assignments = {item["subject_id"]: item for item in data["provisional_grade_assignments"]}
|
||||
grade_order = {grade: index for index, grade in enumerate(
|
||||
[f"faqi-{tier}-{level}" for tier, _ in GRADE_TIERS for level in ("advanced", "intermediate", "initial")])}
|
||||
grade_counts = {grade: sum(item["grade_id"] == grade for item in assignments.values()) for grade in grade_order}
|
||||
importance_levels = (("advanced", "高级"), ("intermediate", "中级"), ("initial", "初级"))
|
||||
distribution = []
|
||||
for tier, tier_label in GRADE_TIERS:
|
||||
tier_levels = [(label, grade_counts[f"faqi-{tier}-{level}"]) for level, label in importance_levels]
|
||||
total = sum(count for _, count in tier_levels)
|
||||
levels = "、".join(f"{label}{count}" for label, count in tier_levels if count)
|
||||
distribution.append(f"{tier_label}{total}条（{levels}）")
|
||||
distribution = "；".join(distribution)
|
||||
subject_details = {
|
||||
**{oid: {"name": obj["name"], "type": obj["type_id"]} for oid, obj in objects.items()},
|
||||
**{obj["id"]: {"name": obj["name"], "type": obj["type_id"]} for obj in graph["objects"]},
|
||||
**{item["id"]: {"name": item["node"], "type": "依赖类别"} for item in graph["dependency_categories"]},
|
||||
|
||||
}
|
||||
|
||||
def grade_display(subject_id):
|
||||
assignment = assignments[subject_id]
|
||||
status = "任务级暂定" if assignment["assignment_status"] == "task_scoped_provisional" else "用户指定重要性暂定"
|
||||
return f"{GRADE_LABELS[assignment['grade_id']]}（{status}）"
|
||||
|
||||
out = [MARKER, "# Vibe Coding法器总分类与重要性分级表", "",
|
||||
"本视图由[法器总分类登记](../metadata/faqi.json)与外部资源原表生成；仅修改登记数据，不手改此文件。",
|
||||
"类型复用[唯一本体](../docs/gongfa/cultivation-ontology-taxonomy.md#唯一分类树)。对象身份、依赖角色与重要性分级分开；品级表示Vibe Coding重要性，不表示实现质量或任务效能。", "",
|
||||
"## 总体概览", "", f"登记版本：{data['format_version']}；更新：{data['reviewed_at']}；依赖图观测：{graph['observed_at']}。",
|
||||
f"本地来源实现 {len(objects)} 条，依赖图具名对象/实例 {len(graph['objects'])} 条，仓内实现关联到图节点 {len(graph['local_links'])} 条，用户确认纳入的依赖类别 {len(graph['dependency_categories'])} 条，重要性分级记录 {len(assignments)} 条，外部资源逐行分流 {len(resources)} 条。",
|
||||
"外部资源行是来源候选或入口，不等同独立法器对象；依赖图深度、节点数量、版本新旧均不推出重要性。", "",
|
||||
"## 重要性分级口径", "",
|
||||
"按用户指令，以Vibe Coding核心闭环重要性、对模型/Agent/工具执行/代码验证的作用及可替代性分层。天阶为定义性AI模型与Agent协作核心；地阶为代码变更、命令执行与运行基础；玄阶为上下文、质量、复用和产品交付增强；黄阶为可替代的专用或便利性支路。各阶高级、中级、初级表示该阶内重要性由高到低。",
|
||||
f"当前分布：{distribution}。这是用户指定的重要性分类，不代表功能质量、实际效果、具体身份已核或正式效能评级；正式效能规约仍为draft且阈值未校准。", "",
|
||||
"## 按天地玄黄品级主键汇总", "",
|
||||
"依赖角色和重要性决定暂定分组；任务烟测、版本观测及来源审查仅作独立事实，不直接决定品级。", "",
|
||||
]
|
||||
for tier, tier_label in GRADE_TIERS:
|
||||
tier_rows = []
|
||||
for assignment in sorted((item for item in assignments.values() if item["grade_id"].split("-")[1] == tier),
|
||||
key=lambda item: (grade_order[item["grade_id"]], item["subject_id"])):
|
||||
detail = subject_details[assignment["subject_id"]]
|
||||
status = "任务级暂定" if assignment["assignment_status"] == "task_scoped_provisional" else "用户指定重要性暂定"
|
||||
tier_rows.append([assignment["grade_id"], assignment["subject_id"], detail["name"], detail["type"], status, assignment["scope"], assignment["basis"]])
|
||||
if not tier_rows:
|
||||
tier_rows = [["—", "—", "暂无记录", "—", "—", "—", "—"]]
|
||||
out += [f"### {tier_label}", "", table(tier_rows, ["品级ID", "对象ID", "对象", "本体类型", "赋级状态", "评定范围", "依据与限制"]), ""]
|
||||
out += ["## Vibe Coding依赖图中的现实对象", "",
|
||||
f"依赖图来源：[技术栈第十六节](../{quote(graph['source_path'], safe='/.-_')}#{quote(graph['source_anchor'], safe='-')})；SHA-256 `{graph['source_sha256']}`。运行时版本观测只绑定本次命令与PATH实例，不证明依赖源码或会话服务端版本。", "",
|
||||
table([[o['id'], o['name'], o['graph_node'], o['type_id'], '运行观测' if o['identity_status'] == 'runtime_observed' else '具名候选', o['version'] or '版本待核', grade_display(o['id'])] for o in graph['objects']], ["对象ID", "对象", "依赖图位置", "本体类型", "身份状态", "版本", "品级"])]
|
||||
for obj in graph["objects"]:
|
||||
resources_text = f"；外部资源：{', '.join(obj['resource_ids'])}" if obj["resource_ids"] else ""
|
||||
link_text = f"；相似本地来源参照：{obj['related_object_id']}（身份关联未证明）" if obj["related_object_id"] else ""
|
||||
out += [f"- `{obj['id']}`：{text(obj['evidence'])}{resources_text}{link_text}；品级分组：{grade_display(obj['id'])}；正式效能仍未验证。{text(obj['grade_reason'])}"]
|
||||
out += ["", "### 用户确认纳入的依赖类别", "",
|
||||
f"用户于 {graph['user_confirmation']['reviewed_at']} 确认此前列出的依赖类别均已核查并要求全部纳入。具体实现身份和版本仍按登记所据分别记录；品级按Vibe Coding重要性暂定，不等于效能验证。",
|
||||
"目标/验收合同、人类授权与取舍、Agent循环、构建/验证/交付过程及反馈仍按角色、内容、过程或关系分类，不因列入依赖范围自动成为软件法器。", "",
|
||||
table([[item['node'], '用户确认纳入', item['reason'], grade_display(item['id'])] for item in graph['dependency_categories']], ["依赖图类别", "纳入状态", "分类边界", "品级分组"]),
|
||||
"", "### 依赖图对应的仓内来源实现", "",
|
||||
"这些行指向已固定来源的本地程序内容；与上方实际运行实例分开，关联不意味着运行版相同。", "",
|
||||
table([[item['object_id'], objects[item['object_id']]['name'], item['graph_node'], item['relationship'], grade_display(item['object_id'])] for item in graph['local_links']], ["本地对象ID", "名称", "依赖图位置", "关系边界", "品级分组"]),
|
||||
"", "## 本地来源限定法器", "",
|
||||
"以下记录只指选定来源的程序指令内容；不同内容实现是否属于同一产品/派生版本，仍须另有演化证据。未出现在依赖图具体工具节点中的仓内工具仍保留在总表。", "",
|
||||
table([[o['id'], o['name'], o['type_id'], o['implementation'], graph_links.get(o['id'], {}).get('graph_node', '图中未具名'), grade_display(o['id'])] for o in objects.values()], ["实现ID", "名称", "本体类型", "实现来源ID", "依赖图位置", "品级分组"])]
|
||||
for obj in objects.values():
|
||||
source = sources[obj['implementation']]
|
||||
out += [f"### {obj['id']}", "", f"{text(obj['name'])}：{text(obj['boundary'])}",
|
||||
f"实现来源 `{source['id']}`，佐证来源 `{', '.join(obj['support'])}`；声明版本：{text(obj['declared_version'] or '未核/无明确发布版本声明')}。", ""]
|
||||
f"实现来源 `{source['id']}`，佐证来源 `{', '.join(obj['support'])}`；声明版本：{text(obj['declared_version'] or '未核/无明确发布版本声明')}。",
|
||||
f"暂定品级分组：{grade_display(obj['id'])}。", ""]
|
||||
out += ["## 按本次范围排除的本地程序所指", "",
|
||||
"下列源码确有程序实现所指，但应用户要求不作为本清单纳入对象；不代表它们不是软件。保留排除证据，重新纳入须满足各自复核条件。", ""]
|
||||
for exclusion in data["local_exclusions"]:
|
||||
@@ -348,8 +437,8 @@ def render(data, sources, objects, resources, decisions):
|
||||
f"- 完整文件SHA-256：`{source['sha256']}`。",
|
||||
f"- 选区：`[{source['lines'][0]},{source['lines'][1]})`；SHA-256：`{source['selection_sha256']}`。", ""]
|
||||
out += ["## 维护与未完成事项", "", "```bash", "make sync-faqi-catalog", "make check-faqi-catalog", "make test-faqi-catalog", "```", "",
|
||||
"检查复用jsonschema/PyYAML，表格复用tabulate；来源、ID、选区、范围或只读视图漂移均失败，不联网补证或静默升级。",
|
||||
"此初审不维护等级、账户、设备、部署或运行证据。独立语义审查、运行/效果/许可核验、产品同一/版本演化及未逐模块展开的复合包仍待核。", ""]
|
||||
"检查复用jsonschema/PyYAML，表格复用tabulate；依赖图、来源、ID、选区、范围或只读视图漂移均失败，不联网补证或静默升级。",
|
||||
"本表未批准独立审查、完整运行/效果、许可、部署、账户或硬件身份。重要性分级与正式效能评价分轴；任务合同、阈值校准、运行版与源码身份桥接及通用图节点的落地实例仍待核。", ""]
|
||||
return "\n".join(out).encode("utf-8")
|
||||
|
||||
|
||||
@@ -368,7 +457,7 @@ def unchanged(bindings, root, data):
|
||||
|
||||
|
||||
def main():
|
||||
parser = argparse.ArgumentParser(description="法器初审来源校验与只读视图维护，不执行被审程序")
|
||||
parser = argparse.ArgumentParser(description="法器总分类登记校验与依赖图只读视图维护，不执行被审程序")
|
||||
parser.add_argument("--root", type=Path, default=ROOT)
|
||||
parser.add_argument("--input", type=Path)
|
||||
parser.add_argument("--view", type=Path)
|
||||
@@ -398,8 +487,11 @@ def main():
|
||||
else:
|
||||
require(before == rendered, "法器视图缺失/陈旧或手改；运行make sync-faqi-catalog")
|
||||
unchanged(bindings, root, data)
|
||||
print(json.dumps({"status": "valid-initial-source-review", "objects": len(objects), "local_entries": len(data['local_entries']),
|
||||
print(json.dumps({"status": "valid-master-classification-register", "objects": len(objects), "local_entries": len(data['local_entries']),
|
||||
"local_exclusions": len(data['local_exclusions']), "external_resources": len(resources),
|
||||
"dependency_objects": len(data['dependency_graph']['objects']),
|
||||
"dependency_categories": len(data['dependency_graph']['dependency_categories']),
|
||||
"provisional_grade_assignments": len(data['provisional_grade_assignments']),
|
||||
"view_sha256": digest(rendered), **data['limits']}, ensure_ascii=False))
|
||||
return 0
|
||||
except (ContractError, OSError, ValueError, KeyError, TypeError, RecursionError, subprocess.TimeoutExpired, yaml.YAMLError, jsonschema.exceptions.SchemaError) as error:
|
||||
|
||||
@@ -2,6 +2,7 @@
|
||||
"""以真实离线CLI消费首批法器清单；保留输入、输出和JUnit，不执行被审工具。"""
|
||||
import argparse
|
||||
import copy
|
||||
from collections import Counter
|
||||
import hashlib
|
||||
import json
|
||||
import os
|
||||
@@ -41,11 +42,45 @@ class FaqiCatalogTest(unittest.TestCase):
|
||||
result = self.invoke("current", "--check")
|
||||
self.assertEqual(0, result.returncode, result.stderr.decode())
|
||||
report = json.loads(result.stdout)
|
||||
self.assertEqual((10, 13, 9, 158), (
|
||||
report["objects"], report["local_entries"], report["local_exclusions"], report["external_resources"]))
|
||||
self.assertEqual((10, 13, 9, 158, 13, 8), (
|
||||
report["objects"], report["local_entries"], report["local_exclusions"], report["external_resources"],
|
||||
report["dependency_objects"], report["dependency_categories"]))
|
||||
self.assertFalse(report["independent_review"])
|
||||
self.assertFalse(report["runtime_verified"])
|
||||
self.assertTrue(report["grades_assigned"])
|
||||
data = json.loads((ROOT / "metadata/faqi.json").read_text(encoding="utf-8"))
|
||||
self.assertEqual("faqi-master-classification-register", data["kind"])
|
||||
dependency_objects = {o["id"]: o for o in data["dependency_graph"]["objects"]}
|
||||
self.assertEqual("1.1.0", dependency_objects["dep-pi-cli"]["version"])
|
||||
self.assertEqual("software-artifact", dependency_objects["dep-pi-cli"]["type_id"])
|
||||
self.assertIn("8类", data["dependency_graph"]["user_confirmation"]["statement"])
|
||||
self.assertEqual(8, len(data["dependency_graph"]["dependency_categories"]))
|
||||
self.assertTrue(all(item["disposition"] == "user_confirmed_in_scope" for item in data["dependency_graph"]["dependency_categories"]))
|
||||
self.assertTrue(all(o["grade_id"] is None and o["grade_status"] == "pending" for o in dependency_objects.values()))
|
||||
assignments = data["provisional_grade_assignments"]
|
||||
expected_subjects = ({o["id"] for o in data["objects"]} | set(dependency_objects) |
|
||||
{node["id"] for node in data["dependency_graph"]["dependency_categories"]})
|
||||
self.assertEqual(expected_subjects, {item["subject_id"] for item in assignments})
|
||||
self.assertTrue(all(item["assignment_status"] == "user_directed_provisional" for item in assignments))
|
||||
self.assertEqual({
|
||||
"faqi-tian-advanced": 2, "faqi-tian-intermediate": 3,
|
||||
"faqi-di-advanced": 3, "faqi-di-intermediate": 5, "faqi-di-initial": 4,
|
||||
"faqi-xuan-advanced": 2, "faqi-xuan-intermediate": 4, "faqi-xuan-initial": 3,
|
||||
"faqi-huang-advanced": 3, "faqi-huang-intermediate": 1, "faqi-huang-initial": 1,
|
||||
}, Counter(item["grade_id"] for item in assignments))
|
||||
self.assertEqual(31, len(assignments))
|
||||
self.assertTrue(all(link["object_id"] in {o["id"] for o in data["objects"]} for link in data["dependency_graph"]["local_links"]))
|
||||
catalog = (ROOT / "tools/faqi-catalog.md").read_text(encoding="utf-8")
|
||||
self.assertIn("## Vibe Coding依赖图中的现实对象", catalog)
|
||||
self.assertIn("### 用户确认纳入的依赖类别", catalog)
|
||||
self.assertIn("### 黄阶", catalog)
|
||||
self.assertIn("### 天阶", catalog)
|
||||
self.assertIn("### 地阶", catalog)
|
||||
self.assertIn("### 玄阶", catalog)
|
||||
self.assertIn("按Vibe Coding重要性", catalog)
|
||||
self.assertIn("黄阶初级（用户指定重要性暂定）", catalog)
|
||||
self.assertIn("dep-wsl2-kernel", catalog)
|
||||
self.assertIn("Codex CLI", catalog)
|
||||
# 首批父仓库来源必须在已发布主线可达，不能依赖仅本地存在的提交。
|
||||
published = subprocess.run(["git", "merge-base", "--is-ancestor", data["source_revision"], "refs/remotes/origin/develop"], cwd=ROOT, capture_output=True, timeout=20)
|
||||
self.assertEqual(0, published.returncode, "父仓库来源不在已发布主线历史可达")
|
||||
@@ -118,6 +153,14 @@ class FaqiCatalogTest(unittest.TestCase):
|
||||
cases.append(("missing-resource", changed))
|
||||
changed = copy.deepcopy(original); changed["objects"][0]["grade"] = "天阶高级"
|
||||
cases.append(("grade-injection", changed))
|
||||
changed = copy.deepcopy(original); changed["provisional_grade_assignments"][0]["grade_id"] = "invented-grade"
|
||||
cases.append(("unsupported-provisional-grade", changed))
|
||||
changed = copy.deepcopy(original); changed["provisional_grade_assignments"].pop()
|
||||
cases.append(("missing-provisional-grade", changed))
|
||||
changed = copy.deepcopy(original); changed["dependency_graph"]["objects"][0]["type_id"] = "invented-platform"
|
||||
cases.append(("unknown-dependency-type", changed))
|
||||
changed = copy.deepcopy(original); changed["dependency_graph"]["source_sha256"] = "0" * 64
|
||||
cases.append(("dependency-graph-source-drift", changed))
|
||||
changed = copy.deepcopy(original); changed["objects"][0]["implementation"] = changed["sources"][0]["id"]
|
||||
cases.append(("description-as-implementation", changed))
|
||||
changed = copy.deepcopy(original)
|
||||
@@ -195,7 +238,7 @@ class FaqiCatalogTest(unittest.TestCase):
|
||||
(root / "metadata").mkdir(); (root / "tools/fixture").mkdir(parents=True)
|
||||
(root / "docs/gongfa").mkdir(parents=True)
|
||||
(root / "assets/external-resources").mkdir(parents=True)
|
||||
for path in ("metadata/faqi.schema.json", "docs/gongfa/cultivation-ontology-taxonomy.md"):
|
||||
for path in ("metadata/faqi.schema.json", "docs/gongfa/cultivation-ontology-taxonomy.md", "docs/gongfa/technology-stack.md"):
|
||||
(root / path).write_bytes((ROOT / path).read_bytes())
|
||||
body = b"def identity(value):\n return value\n"
|
||||
(root / "tools/fixture/main.py").write_bytes(body)
|
||||
@@ -214,6 +257,13 @@ class FaqiCatalogTest(unittest.TestCase):
|
||||
source = {"id": "S01", "purpose": "implementation", "path": "tools/fixture/main.py", "repository": ".", "revision": revision, "sha256": hashlib.sha256(body).hexdigest(), "lines": [1, 3], "selection_sha256": hashlib.sha256(body).hexdigest()}
|
||||
data["sources"] = [source]
|
||||
data["objects"] = [{**data["objects"][0], "id": "faqi-fixture", "implementation": "S01", "support": []}]
|
||||
data["dependency_graph"]["local_links"] = [{"object_id": "faqi-fixture", "graph_node": "fixture node", "relationship": "仅用于隔离表格预算测试。"}]
|
||||
allowed_grade_subjects = {"faqi-fixture"} | {item["id"] for item in data["dependency_graph"]["objects"]} | {item["id"] for item in data["dependency_graph"]["dependency_categories"]}
|
||||
data["provisional_grade_assignments"] = [item for item in data["provisional_grade_assignments"] if item["subject_id"] in allowed_grade_subjects]
|
||||
data["provisional_grade_assignments"].append({"subject_id": "faqi-fixture", "grade_id": "faqi-huang-initial", "assignment_status": "user_directed_provisional", "scope": "宽表隔离夹具", "basis": "仅验证表格预算，不作效果判断。"})
|
||||
for dependency_object in data["dependency_graph"]["objects"]:
|
||||
dependency_object["resource_ids"] = []
|
||||
dependency_object["related_object_id"] = None
|
||||
data["local_entries"] = [{"path": "tools/fixture", "objects": ["faqi-fixture"], "sources": ["S01"], "boundary": "隔离来源形态夹具，不证明工具能力", "pending": []}]
|
||||
ids = []
|
||||
for file_index, source in enumerate(data["external_sources"]):
|
||||
@@ -234,13 +284,24 @@ class FaqiCatalogTest(unittest.TestCase):
|
||||
self.assertIn("FAQI_CATALOG_ERRORS", result.stderr.decode())
|
||||
self.assertFalse(view.exists())
|
||||
|
||||
def test_dependency_graph_table_and_grade_assignments_are_complete(self):
|
||||
data = json.loads((ROOT / "metadata/faqi.json").read_text(encoding="utf-8"))
|
||||
graph = data["dependency_graph"]
|
||||
self.assertEqual("docs/gongfa/technology-stack.md", graph["source_path"])
|
||||
self.assertGreaterEqual(len(graph["objects"]), 12)
|
||||
self.assertGreaterEqual(len(graph["dependency_categories"]), 7)
|
||||
self.assertEqual(9, len(graph["local_links"]))
|
||||
self.assertTrue(data["limits"]["grades_assigned"])
|
||||
result = self.invoke("dependency-graph-table", "--check")
|
||||
self.assertEqual(0, result.returncode, result.stderr.decode())
|
||||
|
||||
def test_strict_json(self):
|
||||
original = (ROOT / "metadata/faqi.json").read_text(encoding="utf-8")
|
||||
for label, text in (
|
||||
("duplicate-json-key", original.replace('{', '{"format_version": 1,', 1)),
|
||||
("non-json-number", original.replace('"format_version": 1', '"format_version": NaN', 1)),
|
||||
("non-json-number", original.replace('"format_version": 2', '"format_version": NaN', 1)),
|
||||
("oversized-json", original + " " * (2 * 1024 * 1024 + 1)),
|
||||
("non-json-infinity", original.replace('"format_version": 1', '"format_version": Infinity', 1)),
|
||||
("non-json-infinity", original.replace('"format_version": 2', '"format_version": Infinity', 1)),
|
||||
):
|
||||
with self.subTest(label=label):
|
||||
path = ARTIFACTS / (label + "-input.json"); path.write_text(text, encoding="utf-8")
|
||||
|
||||
+2
-2
@@ -8,7 +8,7 @@
|
||||
- `tools/prompts-library/`：提示词 Excel、Markdown、JSONL 转换工具。
|
||||
- `tools/chat-vault/`：AI 聊天记录保存工具。
|
||||
- `tools/external/`：第三方工具、外部仓库和 Git submodule。
|
||||
- `faqi-catalog.md`：法器来源限定初审与资源分流的只读生成清单；数据归`metadata/faqi.json`，资源原事实与类型仍归各自唯一所有者。
|
||||
- `faqi-catalog.md`：法器来源限定初审与资源分流的只读生成清单；数据归`metadata/faqi.json`，重要性与边界说明见`docs/gongfa/faqi-system.md`，资源原事实与类型仍归各自唯一所有者。
|
||||
|
||||
## 约束
|
||||
|
||||
@@ -17,4 +17,4 @@
|
||||
- 修改工具行为时，同步更新对应 README、AGENTS 和根目录命令说明。
|
||||
- 外部源码目录除非任务明确要求，否则不要顺手格式化或批量替换。
|
||||
- 法器清单不手改；按`make sync-faqi-catalog`生成，随后`make check-faqi-catalog`与`make test-faqi-catalog`验证，不搬移源码或执行被审程序。
|
||||
- 初审不是工具品级、完整包语义、运行/效果、许可或独立身份批准；文件/入口/副本/版本/产品关系分别核，不按名称或目录计独立法器。
|
||||
- 来源初审与重要性分类彼此独立；重要性分级也不证明完整包语义、运行/效果、许可或独立身份；文件/入口/副本/版本/产品关系分别核，不按名称或目录计独立法器。
|
||||
|
||||
+3
-3
@@ -8,9 +8,9 @@
|
||||
- `tools/chat-vault/`：AI 聊天记录保存工具。
|
||||
- `tools/external/`：外部仓库、第三方工具与 submodule。
|
||||
- `tools/config/`：Codex 等工具配置。
|
||||
- [faqi-catalog.md](faqi-catalog.md)：法器来源限定初审及外部资源分流的只读清单；来源与判定归[metadata/faqi.json](../metadata/faqi.json)，类型归唯一本体，原资源字段仍归资源YAML。
|
||||
- [faqi-catalog.md](faqi-catalog.md)：法器总分类只读表，包含固定来源实现、Vibe Coding依赖图具名对象、用户确认纳入的依赖类别、外部资源分流及重要性分级；判定归[metadata/faqi.json](../metadata/faqi.json)，阅读说明见[法器体系](../docs/gongfa/faqi-system.md)，原资源字段仍归资源YAML。
|
||||
|
||||
## 法器清单维护
|
||||
## 法器总表维护
|
||||
|
||||
```bash
|
||||
make sync-faqi-catalog
|
||||
@@ -20,6 +20,6 @@ make test-faqi-catalog
|
||||
|
||||
不搬移源码、Skill或配置；按程序指令内容、方法/规约、模型、载体、地址及运行实际所指分离。
|
||||
脚本、Lua或嵌入shell的配置可具有程序所指，不因所在目录或后缀一律排除；纯配置、Skill说明与软件实现不强行合并。
|
||||
清单只证明所列固定来源的初审记录，不证明独立产品数、运行正确、许可证、可用性或效果，法器不套功法品级。
|
||||
本表31项按Vibe Coding重要性暂分天5、地12、玄9、黄5；这与本体中的正式任务效果评级分轴，后者仍为未校准草案。依赖类别纳入范围与版本观测不证明具体实现的任务效果、许可证、可用性或来源绑定。
|
||||
当前清单纳入10项；Chat Vault、MC Player Transfer、XHS ZIP→PDF、HTML工具五项及my-nvim共9项按用户范围明确排除，并保留逐项来源证据和重审条件；不表示它们不是软件。
|
||||
新增来源/内容变化先核身份与版本；视图仅由维护脚本生成，不把临时报告或个人目录作为长期数据源。
|
||||
|
||||
+190
-34
@@ -1,99 +1,255 @@
|
||||
<!-- generated: sync-faqi-catalog.py -->
|
||||
# 法器清单与资源初审
|
||||
# Vibe Coding法器总分类与重要性分级表
|
||||
|
||||
来源限定的静态初审，不是效果、可用性、许可证或独立语义批准。仅修改[法器初审数据](../metadata/faqi.json)，不手改此视图。
|
||||
类型与关系复用[唯一本体](../docs/gongfa/cultivation-ontology-taxonomy.md#唯一分类树)，不维护第二主树，不套功法四阶十二级。
|
||||
本视图由[法器总分类登记](../metadata/faqi.json)与外部资源原表生成；仅修改登记数据，不手改此文件。
|
||||
类型复用[唯一本体](../docs/gongfa/cultivation-ontology-taxonomy.md#唯一分类树)。对象身份、依赖角色与重要性分级分开；品级表示Vibe Coding重要性，不表示实现质量或任务效能。
|
||||
|
||||
## 总体概览
|
||||
|
||||
初审时间：2026-10-10T04:30:59+00:00；父仓库来源修订：`0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2`。
|
||||
本地入口 13 个，来源限定法器实现初审 10 条，另有 9 条明确范围排除；外部资源逐行分流 158 条。不是按目录或资源行计算独立产品数。
|
||||
程序源码修订和下表声明版本不等于已核发布版、已安装版本或已部署入口；同内容副本、多入口不重复登记。
|
||||
登记版本：2；更新：2026-10-11T06:19:20+00:00；依赖图观测：2026-10-10T12:14:00Z。
|
||||
本地来源实现 10 条，依赖图具名对象/实例 13 条，仓内实现关联到图节点 9 条，用户确认纳入的依赖类别 8 条，重要性分级记录 31 条，外部资源逐行分流 158 条。
|
||||
外部资源行是来源候选或入口，不等同独立法器对象；依赖图深度、节点数量、版本新旧均不推出重要性。
|
||||
|
||||
## 重要性分级口径
|
||||
|
||||
按用户指令，以Vibe Coding核心闭环重要性、对模型/Agent/工具执行/代码验证的作用及可替代性分层。天阶为定义性AI模型与Agent协作核心；地阶为代码变更、命令执行与运行基础；玄阶为上下文、质量、复用和产品交付增强；黄阶为可替代的专用或便利性支路。各阶高级、中级、初级表示该阶内重要性由高到低。
|
||||
当前分布：天阶5条（高级2、中级3）；地阶12条（高级3、中级5、初级4）；玄阶9条（高级2、中级4、初级3）；黄阶5条（高级3、中级1、初级1）。这是用户指定的重要性分类，不代表功能质量、实际效果、具体身份已核或正式效能评级；正式效能规约仍为draft且阈值未校准。
|
||||
|
||||
## 按天地玄黄品级主键汇总
|
||||
|
||||
依赖角色和重要性决定暂定分组；任务烟测、版本观测及来源审查仅作独立事实，不直接决定品级。
|
||||
|
||||
### 天阶
|
||||
|
||||
```text
|
||||
+---------------------+------------+
|
||||
| 外部分流状态 | 资源行数 |
|
||||
|---------------------+------------|
|
||||
| 软件实现候选 | 67 |
|
||||
| 托管入口候选 | 22 |
|
||||
| 排除：资料/规约内容 | 38 |
|
||||
| 排除：模型名称所指 | 4 |
|
||||
| 待核：对象身份 | 22 |
|
||||
| 关联已审本地来源 | 2 |
|
||||
| 待核：受限服务所指 | 3 |
|
||||
+---------------------+------------+
|
||||
+------------------------+--------------------------------+---------------------------------------+-------------------+--------------------+------------------------------------------------+-----------------------------------------------------------------------------------------------------------------+
|
||||
| 品级ID | 对象ID | 对象 | 本体类型 | 赋级状态 | 评定范围 | 依据与限制 |
|
||||
|------------------------+--------------------------------+---------------------------------------+-------------------+--------------------+------------------------------------------------+-----------------------------------------------------------------------------------------------------------------|
|
||||
| faqi-tian-advanced | dep-category-cloud-model-api | 2.2 云端模型服务/API与固定模型版本 | 依赖类别 | 用户指定重要性暂定 | Vibe Coding重要性：核心模型推理与代码生成 | 提供理解需求、推理和生成代码的核心智能能力；没有模型推理路径即失去Vibe Coding的定义性特征，供应商与模型可替换。 |
|
||||
| faqi-tian-advanced | dep-pi-cli | Pi Agent CLI（当前 PATH 实例） | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：当前核心Agent运行与工具编排 | 直接承接需求、上下文、模型调用和工具执行循环；当前环境的核心交互入口，缺失会改变Vibe Coding核心形态。 |
|
||||
| faqi-tian-intermediate | dep-category-local-model-stack | 2.2 本地模型权重、Tokenizer与推理引擎 | 依赖类别 | 用户指定重要性暂定 | Vibe Coding重要性：本地/离线模型推理路径 | 可提供核心模型推理并支持本地化、隐私或离线需求；在通用工作流中可由云端推理替代，故低于定义性核心路径。 |
|
||||
| faqi-tian-intermediate | dep-claude-code | Claude Code（依赖图替代项） | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：替代Agent运行时 | 若选用可承担AI代码协作与工具编排核心；当前仅具名候选且可与其他运行时替换，低于已用核心路径。 |
|
||||
| faqi-tian-intermediate | dep-codex-cli | Codex CLI（依赖图替代项） | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：替代Agent运行时 | 若选用可承担AI代码协作与工具编排核心；当前仅具名候选且可与其他运行时替换，低于已用核心路径。 |
|
||||
+------------------------+--------------------------------+---------------------------------------+-------------------+--------------------+------------------------------------------------+-----------------------------------------------------------------------------------------------------------------+
|
||||
```
|
||||
|
||||
|
||||
### 地阶
|
||||
|
||||
```text
|
||||
+----------------------+------------------------------+---------------------------------------------+-------------------+--------------------+------------------------------------------------+--------------------------------------------------------------------------------------------------------------+
|
||||
| 品级ID | 对象ID | 对象 | 本体类型 | 赋级状态 | 评定范围 | 依据与限制 |
|
||||
|----------------------+------------------------------+---------------------------------------------+-------------------+--------------------+------------------------------------------------+--------------------------------------------------------------------------------------------------------------|
|
||||
| faqi-di-advanced | dep-bash | GNU Bash | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：Agent命令执行与脚本交互 | 直接承接终端命令、开发脚本和验证操作，是当前Agent落地代码动作的高重要性接口；Shell实现可替代但该角色不可缺。 |
|
||||
| faqi-di-advanced | dep-category-terminal-pty | 3.2 Terminal Emulator / PTY | 依赖类别 | 用户指定重要性暂定 | Vibe Coding重要性：Agent调用工具与执行开发命令 | 把Agent计划转成真实文件、构建和测试操作的关键执行边界；没有等价工具执行通道，代码闭环无法完成。 |
|
||||
| faqi-di-advanced | dep-git-client | Git 本地客户端 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：代码变更追踪、比较与恢复 | 支撑审查AI改动、保留版本历史和安全回退，是可维护代码生成闭环的高重要性基础；版本控制实现可替代。 |
|
||||
| faqi-di-intermediate | dep-category-infrastructure | 8 CPU/GPU、内存、存储、网络、电力与数据中心 | 依赖类别 | 用户指定重要性暂定 | Vibe Coding重要性：计算、存储与网络承载 | 为模型调用、代码执行及数据交换提供资源底座；实现可跨云、主机和本地环境替换，故不是单一核心产品。 |
|
||||
| faqi-di-intermediate | dep-category-package-sources | 4.2 包注册表、Git源与可信缓存 | 依赖类别 | 用户指定重要性暂定 | Vibe Coding重要性：依赖获取、锁定与复现 | 支持安装成熟组件、解析代码依赖和重建开发环境；具体注册表与来源有替代，不直接承担AI生成。 |
|
||||
| faqi-di-intermediate | dep-nodejs-runtime | Node.js 运行时 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：前端及工具链代码运行 | 支撑前端、Node项目和本仓Markdown工具链；具体语言环境可替代，重要性低于通用Agent与终端执行核心。 |
|
||||
| faqi-di-intermediate | dep-npm-npx | npm / npx 工具 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：Node依赖解析与工具调用 | 让Node生态依赖和命令行工具可安装、解析与调用；作用范围依赖项目技术栈，可由其他生态包管理器替代。 |
|
||||
| faqi-di-intermediate | dep-python-runtime | Python 运行时 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：脚本、工具与项目代码运行 | 支撑本仓工具及大量Python项目的执行和验证；语言运行时可按项目替代，重要但非所有Vibe Coding任务必需。 |
|
||||
| faqi-di-initial | dep-gnu-make | GNU Make | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：可重复构建与检查入口 | 把构建和验证命令组织成可重复入口有助于交付，但Make可由其他任务运行器或脚本替代。 |
|
||||
| faqi-di-initial | dep-ubuntu-userland | Ubuntu 用户空间发行版 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：当前Linux用户空间 | 承载当前工具链和本地命令，但同类操作系统环境可以替代，重要性来自运行基座而非该发行版身份。 |
|
||||
| faqi-di-initial | dep-wsl2-kernel | WSL2 Linux 内核 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：当前运行环境内核 | 提供当前WSL用户空间的执行底座，但存在其他内核和宿主替代，不属于AI编程核心能力。 |
|
||||
| faqi-di-initial | dep-wsl2-platform | WSL 2 承载平台 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：当前宿主环境实现 | 为当前工具链提供运行宿主，但Linux、macOS或原生Windows等环境可替代，不是Vibe Coding定义性能力。 |
|
||||
+----------------------+------------------------------+---------------------------------------------+-------------------+--------------------+------------------------------------------------+--------------------------------------------------------------------------------------------------------------+
|
||||
```
|
||||
|
||||
|
||||
### 玄阶
|
||||
|
||||
```text
|
||||
+------------------------+-------------------------------+-----------------------------------------------------------+-------------------+--------------------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------+
|
||||
| 品级ID | 对象ID | 对象 | 本体类型 | 赋级状态 | 评定范围 | 依据与限制 |
|
||||
|------------------------+-------------------------------+-----------------------------------------------------------+-------------------+--------------------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------|
|
||||
| faqi-xuan-advanced | dep-category-ci-platform | 7.1 Git托管、CI Runner与CI/CD平台 | 依赖类别 | 用户指定重要性暂定 | Vibe Coding重要性：自动化验证、协作与持续交付 | 把代码生成接入可重复测试、审查和协作交付，显著扩展可靠使用范围；本地闭环可运行但难以替代团队级持续验证。 |
|
||||
| faqi-xuan-advanced | dep-category-retrieval-memory | 2.3 检索/索引/记忆与向量库 | 依赖类别 | 用户指定重要性暂定 | Vibe Coding重要性：长程上下文、知识检索与记忆 | 支撑跨文件和长任务上下文保持、历史知识复用，提升复杂任务可处理范围；短任务仍可不依赖，且实现可替换。 |
|
||||
| faqi-xuan-intermediate | dep-category-deployment-data | 7.2-7.3 制品注册表、部署目标、产品运行时、数据库与外部API | 依赖类别 | 用户指定重要性暂定 | Vibe Coding重要性：从代码到产品运行与外部集成 | 支撑部署、数据库和API集成，使代码进入真实产品场景；并非每次编码必需，故属于重要交付扩展而非核心生成。 |
|
||||
| faqi-xuan-intermediate | faqi-auto-skill-create | auto-skill模板生成脚本 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：技能资产扩展与复用 | 把操作知识封装为可复用Agent技能，能扩展后续任务能力；属于增益支路，不是最小编码闭环的必需组件。 |
|
||||
| faqi-xuan-intermediate | faqi-auto-skill-validate | auto-skill结构校验脚本 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：技能资产质量与可载入性 | 降低扩展技能结构错误造成的接入阻断；不判断语义正确性，属于能力扩展的质量辅助。 |
|
||||
| faqi-xuan-intermediate | faqi-skill-seekers | Skill Seekers程序 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：外部知识转可复用技能 | 增加Agent可复用的领域能力和上下文资产；需特定工作流，不能替代通用推理与工具执行。 |
|
||||
| faqi-xuan-initial | faqi-claude-skill-init | 官方Skill初始化脚本 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：特定Skill模板初始化 | 降低Claude Skill结构初始化成本，作用范围绑定特定生态，可手工完成且不影响其他Agent的基础闭环。 |
|
||||
| faqi-xuan-initial | faqi-codex-config-installer | Codex配置安装与恢复脚本 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：特定Agent接入配置 | 降低特定Agent初始配置成本，但只服务候选运行时且可手工替代；不属于核心模型推理或执行闭环。 |
|
||||
| faqi-xuan-initial | faqi-skill-seekers-adapter | Skill Seekers本地运行适配脚本 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：Skill Seekers本地适配入口 | 便于调用特定知识转技能工具；范围受上游工具限制，可直接调用或人工替代。 |
|
||||
+------------------------+-------------------------------+-----------------------------------------------------------+-------------------+--------------------+-----------------------------------------------+----------------------------------------------------------------------------------------------------------+
|
||||
```
|
||||
|
||||
|
||||
### 黄阶
|
||||
|
||||
```text
|
||||
+-------------------------+-----------------------+--------------------------+-------------------+--------------------+-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------+
|
||||
| 品级ID | 对象ID | 对象 | 本体类型 | 赋级状态 | 评定范围 | 依据与限制 |
|
||||
|-------------------------+-----------------------+--------------------------+-------------------+--------------------+-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------|
|
||||
| faqi-huang-advanced | dep-tmux-runtime | tmux 当前运行实例 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：长任务与多会话终端复用 | 可持久化和并行组织终端工作，复杂协作时有价值；普通单会话开发可替代，不属于核心生成链。 |
|
||||
| faqi-huang-advanced | faqi-auto-tmux | auto-tmux命令封装程序 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：多会话终端协作自动化 | 能管理多会话和worker工作流，复杂并行时有用；基础单Agent编码不依赖，且当前doctor烟测失败，重要性不等于实现质量。 |
|
||||
| faqi-huang-advanced | faqi-tmux | tmux终端复用程序 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：可选的多会话终端复用 | 支持持久终端与多窗口工作流，复杂长任务可受益；普通编码闭环有替代方案，不属定义性核心。 |
|
||||
| faqi-huang-intermediate | faqi-oh-my-tmux | oh-my-tmux可执行配置程序 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：终端复用器体验配置 | 改善tmux使用便利性，但不提供模型推理或核心代码执行能力，可由其他终端配置替代。 |
|
||||
| faqi-huang-initial | faqi-prompt-converter | 提示词格式转换程序 | software-artifact | 用户指定重要性暂定 | Vibe Coding重要性：提示词资产格式迁移的辅助支路 | 只负责格式转换，能维护和复用提示词资产但不参与模型推理或代码执行；替代方式多，属低重要性辅助。 |
|
||||
+-------------------------+-----------------------+--------------------------+-------------------+--------------------+-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------+
|
||||
```
|
||||
|
||||
|
||||
## Vibe Coding依赖图中的现实对象
|
||||
|
||||
依赖图来源：[技术栈第十六节](../docs/gongfa/technology-stack.md#reference-technology-stack-%E5%8D%81%E5%85%AD%E6%8A%80%E6%9C%AF%E6%A0%88%E7%9A%84%E5%B1%82%E7%BA%A7%E7%BB%93%E6%9E%84)；SHA-256 `88ff3494095c2a794acf130d5d2ccc4eb4b67ccdc8c174e7ef09f35c11a450a2`。运行时版本观测只绑定本次命令与PATH实例，不证明依赖源码或会话服务端版本。
|
||||
|
||||
```text
|
||||
+---------------------+--------------------------------+----------------------------------------+-------------------+------------+----------------------------------+--------------------------------+
|
||||
| 对象ID | 对象 | 依赖图位置 | 本体类型 | 身份状态 | 版本 | 品级 |
|
||||
|---------------------+--------------------------------+----------------------------------------+-------------------+------------+----------------------------------+--------------------------------|
|
||||
| dep-pi-cli | Pi Agent CLI（当前 PATH 实例） | 2.1 Agent运行时 / Pi Agent | software-artifact | 运行观测 | 1.1.0 | 天阶高级（用户指定重要性暂定） |
|
||||
| dep-codex-cli | Codex CLI（依赖图替代项） | 2.1 Agent运行时 / Codex替代项 | software-artifact | 具名候选 | 版本待核 | 天阶中级（用户指定重要性暂定） |
|
||||
| dep-claude-code | Claude Code（依赖图替代项） | 2.1 Agent运行时 / Claude Code替代项 | software-artifact | 具名候选 | 版本待核 | 天阶中级（用户指定重要性暂定） |
|
||||
| dep-wsl2-platform | WSL 2 承载平台 | 6.1 Windows主机 / WSL | software-artifact | 运行观测 | 版本待核 | 地阶初级（用户指定重要性暂定） |
|
||||
| dep-ubuntu-userland | Ubuntu 用户空间发行版 | 6.1 Linux发行版 / Ubuntu | software-artifact | 运行观测 | 24.04.3 LTS | 地阶初级（用户指定重要性暂定） |
|
||||
| dep-wsl2-kernel | WSL2 Linux 内核 | 6.1 WSL / 版本对应的Linux内核 | software-artifact | 运行观测 | 6.6.87.2-microsoft-standard-WSL2 | 地阶初级（用户指定重要性暂定） |
|
||||
| dep-bash | GNU Bash | 6.2 Shell与命令解释器 | software-artifact | 运行观测 | 5.2.21 | 地阶高级（用户指定重要性暂定） |
|
||||
| dep-python-runtime | Python 运行时 | 4.3 语言与运行时 | software-artifact | 运行观测 | 3.12.3 | 地阶中级（用户指定重要性暂定） |
|
||||
| dep-nodejs-runtime | Node.js 运行时 | 4.3 语言与运行时 | software-artifact | 运行观测 | 22.23.2 | 地阶中级（用户指定重要性暂定） |
|
||||
| dep-npm-npx | npm / npx 工具 | 4.2 包管理器与依赖解析器 | software-artifact | 运行观测 | 10.9.8 | 地阶中级（用户指定重要性暂定） |
|
||||
| dep-git-client | Git 本地客户端 | 3.2 文件与代码 / Git本地客户端与工作树 | software-artifact | 运行观测 | 2.43.0 | 地阶高级（用户指定重要性暂定） |
|
||||
| dep-gnu-make | GNU Make | 4.3 构建系统 | software-artifact | 运行观测 | 4.3 | 地阶初级（用户指定重要性暂定） |
|
||||
| dep-tmux-runtime | tmux 当前运行实例 | 3.2 命令/终端 / tmux复用支路 | software-artifact | 运行观测 | 3.4 | 黄阶高级（用户指定重要性暂定） |
|
||||
+---------------------+--------------------------------+----------------------------------------+-------------------+------------+----------------------------------+--------------------------------+
|
||||
```
|
||||
|
||||
- `dep-pi-cli`：pi --version 输出 1.1.0；type -a 显示多个同名入口，本记录只绑定当前 shell 选中的入口；先前环境记录为 1.0.4，宿主/路径差异待核，不将此版本绑定到会话服务端。；品级分组：天阶高级（用户指定重要性暂定）；正式效能仍未验证。分级量表仍为 draft，初/中/高结果带阈值未校准；本条未建立任务族效果合同。
|
||||
- `dep-codex-cli`：依赖图及外部资源行指向 Codex CLI 候选；当前安装身份、可执行入口、版本与来源未核。；外部资源：tools-platforms-codex-cli-362bc20a；品级分组：天阶中级（用户指定重要性暂定）；正式效能仍未验证。精确实现/版本、任务合同及分级量表阈值待核。
|
||||
- `dep-claude-code`：依赖图及外部资源行指向 Claude Code 候选；当前安装身份、可执行入口、版本与来源未核。；外部资源：tools-platforms-claude-code-11b1e88d；品级分组：天阶中级（用户指定重要性暂定）；正式效能仍未验证。精确实现/版本、任务合同及分级量表阈值待核。
|
||||
- `dep-wsl2-platform`：uname -r 含 microsoft-standard-WSL2，确认当前 Linux 内核运行在 WSL2 兼容环境；Windows宿主版本及 WSL 产品版本未核。；品级分组：地阶初级（用户指定重要性暂定）；正式效能仍未验证。承载平台精确版本、任务合同及分级量表阈值待核。
|
||||
- `dep-ubuntu-userland`：/etc/os-release 报告 Ubuntu 24.04.3 LTS（VERSION_ID=24.04）。；品级分组：地阶初级（用户指定重要性暂定）；正式效能仍未验证。版本观测不等于具体任务效果；分级量表阈值未校准。
|
||||
- `dep-wsl2-kernel`：uname -r 输出 6.6.87.2-microsoft-standard-WSL2；不据内核版本推断 Windows/WSL 产品版本。；品级分组：地阶初级（用户指定重要性暂定）；正式效能仍未验证。版本观测不等于具体任务效果；分级量表阈值未校准。
|
||||
- `dep-bash`：bash --version 输出 GNU bash 5.2.21。；品级分组：地阶高级（用户指定重要性暂定）；正式效能仍未验证。版本观测不等于具体任务效果；分级量表阈值未校准。
|
||||
- `dep-python-runtime`：python3 --version 输出 Python 3.12.3。；品级分组：地阶中级（用户指定重要性暂定）；正式效能仍未验证。版本观测不等于具体任务效果；分级量表阈值未校准。
|
||||
- `dep-nodejs-runtime`：node --version 输出 v22.23.2。；品级分组：地阶中级（用户指定重要性暂定）；正式效能仍未验证。版本观测不等于具体任务效果；分级量表阈值未校准。
|
||||
- `dep-npm-npx`：npm --version 与 npx --version 均输出 10.9.8；登记为同一当前工具链版本观测，不把命令入口重复计数为两件法器。；品级分组：地阶中级（用户指定重要性暂定）；正式效能仍未验证。版本观测不等于具体任务效果；分级量表阈值未校准。
|
||||
- `dep-git-client`：git --version 输出 git version 2.43.0。；品级分组：地阶高级（用户指定重要性暂定）；正式效能仍未验证。版本观测不等于具体任务效果；分级量表阈值未校准。
|
||||
- `dep-gnu-make`：make --version 输出 GNU Make 4.3。；品级分组：地阶初级（用户指定重要性暂定）；正式效能仍未验证。版本观测不等于具体任务效果；分级量表阈值未校准。
|
||||
- `dep-tmux-runtime`：tmux -V 输出 tmux 3.4；本次隔离 session smoke 不能证明二进制来自已登记 faqi-tmux 的固定源码修订。；相似本地来源参照：faqi-tmux（身份关联未证明）；品级分组：黄阶高级（用户指定重要性暂定）；正式效能仍未验证。运行实例与固定源码身份尚未桥接；任务族结果带与分级量表阈值未校准。
|
||||
|
||||
### 用户确认纳入的依赖类别
|
||||
|
||||
用户于 2026-10-10T14:28:10Z 确认此前列出的依赖类别均已核查并要求全部纳入。具体实现身份和版本仍按登记所据分别记录；品级按Vibe Coding重要性暂定，不等于效能验证。
|
||||
目标/验收合同、人类授权与取舍、Agent循环、构建/验证/交付过程及反馈仍按角色、内容、过程或关系分类，不因列入依赖范围自动成为软件法器。
|
||||
|
||||
```text
|
||||
+-----------------------------------------------------------+--------------+--------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------+
|
||||
| 依赖图类别 | 纳入状态 | 分类边界 | 品级分组 |
|
||||
|-----------------------------------------------------------+--------------+--------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------|
|
||||
| 2.2 云端模型服务/API与固定模型版本 | 用户确认纳入 | 用户确认此依赖类别已核并要求纳入；服务/API与模型制品仍分开登记；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。 | 天阶高级（用户指定重要性暂定） |
|
||||
| 2.2 本地模型权重、Tokenizer与推理引擎 | 用户确认纳入 | 用户确认此依赖类别已核并要求纳入；模型制品、Tokenizer与推理程序分别判断；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。 | 天阶中级（用户指定重要性暂定） |
|
||||
| 3.2 Terminal Emulator / PTY | 用户确认纳入 | 用户确认此依赖类别已核并要求纳入；终端模拟器与PTY系统接口分开分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。 | 地阶高级（用户指定重要性暂定） |
|
||||
| 4.2 包注册表、Git源与可信缓存 | 用户确认纳入 | 用户确认此依赖类别已核并要求纳入；注册表、Git来源与缓存分开分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。 | 地阶中级（用户指定重要性暂定） |
|
||||
| 7.1 Git托管、CI Runner与CI/CD平台 | 用户确认纳入 | 用户确认此依赖类别已核并要求纳入；托管服务、Runner执行环境与CI/CD平台分开分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。 | 玄阶高级（用户指定重要性暂定） |
|
||||
| 7.2-7.3 制品注册表、部署目标、产品运行时、数据库与外部API | 用户确认纳入 | 用户确认此可选依赖类别已核并要求纳入；注册表、部署环境、运行时、数据库与外部API分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。 | 玄阶中级（用户指定重要性暂定） |
|
||||
| 8 CPU/GPU、内存、存储、网络、电力与数据中心 | 用户确认纳入 | 用户确认此资源类别已核并要求纳入；物理设备、基础设施与供给服务按所指分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。 | 地阶中级（用户指定重要性暂定） |
|
||||
| 2.3 检索/索引/记忆与向量库 | 用户确认纳入 | 用户确认此可选依赖类别已核并要求纳入；检索过程、索引、记忆内容与向量存储分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。 | 玄阶高级（用户指定重要性暂定） |
|
||||
+-----------------------------------------------------------+--------------+--------------------------------------------------------------------------------------------------------------------------------------------------+--------------------------------+
|
||||
```
|
||||
|
||||
|
||||
### 依赖图对应的仓内来源实现
|
||||
|
||||
这些行指向已固定来源的本地程序内容；与上方实际运行实例分开，关联不意味着运行版相同。
|
||||
|
||||
```text
|
||||
+-----------------------------+-------------------------------+---------------------------------------------+--------------------------------------------------------------+--------------------------------+
|
||||
| 本地对象ID | 名称 | 依赖图位置 | 关系边界 | 品级分组 |
|
||||
|-----------------------------+-------------------------------+---------------------------------------------+--------------------------------------------------------------+--------------------------------|
|
||||
| faqi-codex-config-installer | Codex配置安装与恢复脚本 | 2.1 Agent运行时 / Codex替代项 | 本地配置辅助脚本；不是Codex CLI实现。 | 玄阶初级（用户指定重要性暂定） |
|
||||
| faqi-auto-skill-create | auto-skill模板生成脚本 | 2.3 Harness与上下文 / 可选Skill制作支路 | 实现仓内Skill骨架生成入口。 | 玄阶中级（用户指定重要性暂定） |
|
||||
| faqi-auto-skill-validate | auto-skill结构校验脚本 | 2.3 Harness与上下文 / 可选Skill制作支路 | 实现仓内Skill结构检查入口。 | 玄阶中级（用户指定重要性暂定） |
|
||||
| faqi-skill-seekers-adapter | Skill Seekers本地运行适配脚本 | 2.3 Harness与上下文 / Skill Seekers适配入口 | 适配到固定submodule源码；本机依赖状态另核。 | 玄阶初级（用户指定重要性暂定） |
|
||||
| faqi-skill-seekers | Skill Seekers程序 | 2.3 Harness与上下文 / Skill Seekers上游程序 | 固定submodule中的上游程序实现。 | 玄阶中级（用户指定重要性暂定） |
|
||||
| faqi-claude-skill-init | 官方Skill初始化脚本 | 2.3 Harness与上下文 / 可选Skill制作支路 | 第三方Skill集合中的独立初始化脚本，不等于Claude Code运行时。 | 玄阶初级（用户指定重要性暂定） |
|
||||
| faqi-auto-tmux | auto-tmux命令封装程序 | 3.2 命令/终端 / auto-tmux封装 | 依赖PATH中的tmux CLI及Shell。 | 黄阶高级（用户指定重要性暂定） |
|
||||
| faqi-oh-my-tmux | oh-my-tmux可执行配置程序 | 3.2 命令/终端 / oh-my-tmux配置 | 依赖tmux与Shell的可执行配置，不是tmux本体。 | 黄阶中级（用户指定重要性暂定） |
|
||||
| faqi-tmux | tmux终端复用程序 | 3.2 命令/终端 / tmux CLI、Server、Socket | 固定源码内容；本地运行实例来源桥接待核。 | 黄阶高级（用户指定重要性暂定） |
|
||||
+-----------------------------+-------------------------------+---------------------------------------------+--------------------------------------------------------------+--------------------------------+
|
||||
```
|
||||
|
||||
|
||||
## 本地来源限定法器
|
||||
|
||||
以下记录只指选定来源的程序指令内容；不同内容实现是否属于同一产品/派生版本，仍须另有演化证据。用途不作为主父。
|
||||
以下记录只指选定来源的程序指令内容；不同内容实现是否属于同一产品/派生版本，仍须另有演化证据。未出现在依赖图具体工具节点中的仓内工具仍保留在总表。
|
||||
|
||||
```text
|
||||
+-----------------------------+-------------------------------+-------------------+--------------+
|
||||
| 实现ID | 名称 | 已有类型ID | 实现来源ID |
|
||||
|-----------------------------+-------------------------------+-------------------+--------------|
|
||||
| faqi-prompt-converter | 提示词格式转换程序 | software-artifact | S02 |
|
||||
| faqi-codex-config-installer | Codex配置安装与恢复脚本 | software-artifact | S06 |
|
||||
| faqi-auto-skill-create | auto-skill模板生成脚本 | software-artifact | S08 |
|
||||
| faqi-auto-skill-validate | auto-skill结构校验脚本 | software-artifact | S09 |
|
||||
| faqi-skill-seekers-adapter | Skill Seekers本地运行适配脚本 | software-artifact | S10 |
|
||||
| faqi-auto-tmux | auto-tmux命令封装程序 | software-artifact | S12 |
|
||||
| faqi-skill-seekers | Skill Seekers程序 | software-artifact | S16 |
|
||||
| faqi-oh-my-tmux | oh-my-tmux可执行配置程序 | software-artifact | S18 |
|
||||
| faqi-tmux | tmux终端复用程序 | software-artifact | S21 |
|
||||
| faqi-claude-skill-init | 官方Skill初始化脚本 | software-artifact | S23 |
|
||||
+-----------------------------+-------------------------------+-------------------+--------------+
|
||||
+-----------------------------+-------------------------------+-------------------+--------------+---------------------------------------------+--------------------------------+
|
||||
| 实现ID | 名称 | 本体类型 | 实现来源ID | 依赖图位置 | 品级分组 |
|
||||
|-----------------------------+-------------------------------+-------------------+--------------+---------------------------------------------+--------------------------------|
|
||||
| faqi-prompt-converter | 提示词格式转换程序 | software-artifact | S02 | 图中未具名 | 黄阶初级（用户指定重要性暂定） |
|
||||
| faqi-codex-config-installer | Codex配置安装与恢复脚本 | software-artifact | S06 | 2.1 Agent运行时 / Codex替代项 | 玄阶初级（用户指定重要性暂定） |
|
||||
| faqi-auto-skill-create | auto-skill模板生成脚本 | software-artifact | S08 | 2.3 Harness与上下文 / 可选Skill制作支路 | 玄阶中级（用户指定重要性暂定） |
|
||||
| faqi-auto-skill-validate | auto-skill结构校验脚本 | software-artifact | S09 | 2.3 Harness与上下文 / 可选Skill制作支路 | 玄阶中级（用户指定重要性暂定） |
|
||||
| faqi-skill-seekers-adapter | Skill Seekers本地运行适配脚本 | software-artifact | S10 | 2.3 Harness与上下文 / Skill Seekers适配入口 | 玄阶初级（用户指定重要性暂定） |
|
||||
| faqi-auto-tmux | auto-tmux命令封装程序 | software-artifact | S12 | 3.2 命令/终端 / auto-tmux封装 | 黄阶高级（用户指定重要性暂定） |
|
||||
| faqi-skill-seekers | Skill Seekers程序 | software-artifact | S16 | 2.3 Harness与上下文 / Skill Seekers上游程序 | 玄阶中级（用户指定重要性暂定） |
|
||||
| faqi-oh-my-tmux | oh-my-tmux可执行配置程序 | software-artifact | S18 | 3.2 命令/终端 / oh-my-tmux配置 | 黄阶中级（用户指定重要性暂定） |
|
||||
| faqi-tmux | tmux终端复用程序 | software-artifact | S21 | 3.2 命令/终端 / tmux CLI、Server、Socket | 黄阶高级（用户指定重要性暂定） |
|
||||
| faqi-claude-skill-init | 官方Skill初始化脚本 | software-artifact | S23 | 2.3 Harness与上下文 / 可选Skill制作支路 | 玄阶初级（用户指定重要性暂定） |
|
||||
+-----------------------------+-------------------------------+-------------------+--------------+---------------------------------------------+--------------------------------+
|
||||
```
|
||||
|
||||
### faqi-prompt-converter
|
||||
|
||||
提示词格式转换程序：指main.py及其转换实现所表达的程序内容；Excel、Markdown和JSONL是输入/输出，不随转换模式复制工具身份。未验证转换正确性。
|
||||
实现来源 `S02`，佐证来源 `S01`；声明版本：未核/无明确发布版本声明。
|
||||
暂定品级分组：黄阶初级（用户指定重要性暂定）。
|
||||
|
||||
### faqi-codex-config-installer
|
||||
|
||||
Codex配置安装与恢复脚本：纳入安装脚本的程序指令；不是Codex CLI实现，不包含账号授权，safe/power配置、全局指令文本另作规约内容。备份/覆盖能力尚未运行验证。
|
||||
实现来源 `S06`，佐证来源 `S05`；声明版本：未核/无明确发布版本声明。
|
||||
暂定品级分组：玄阶初级（用户指定重要性暂定）。
|
||||
|
||||
### faqi-auto-skill-create
|
||||
|
||||
auto-skill模板生成脚本：指渲染Skill模板与建立目录的程序，不是生成出的Skill内容或整个元技能。--force可覆盖目标，未执行。
|
||||
实现来源 `S08`，佐证来源 `S07`；声明版本：未核/无明确发布版本声明。
|
||||
暂定品级分组：玄阶中级（用户指定重要性暂定）。
|
||||
|
||||
### faqi-auto-skill-validate
|
||||
|
||||
auto-skill结构校验脚本：指frontmatter和结构校验程序；成功结构检查不证明Skill语义、执行正确或效果。
|
||||
实现来源 `S09`，佐证来源 `S07`；声明版本：未核/无明确发布版本声明。
|
||||
暂定品级分组：玄阶中级（用户指定重要性暂定）。
|
||||
|
||||
### faqi-skill-seekers-adapter
|
||||
|
||||
Skill Seekers本地运行适配脚本：设置venv/PYTHONPATH并exec上游CLI的本地适配程序。指令内容不同于上游核心，不能把封装当同一副本，也不因同一用途合并其他生成脚本。
|
||||
实现来源 `S10`，佐证来源 `S07`；声明版本：未核/无明确发布版本声明。
|
||||
暂定品级分组：玄阶初级（用户指定重要性暂定）。
|
||||
|
||||
### faqi-auto-tmux
|
||||
|
||||
auto-tmux命令封装程序：指统一操控脚本，不是SKILL.md、tmux二进制、session/pane或某次操作；支持多命令不增加身份。未发送按键、创建会话或读取pane。
|
||||
实现来源 `S12`，佐证来源 `S11`；声明版本：未核/无明确发布版本声明。
|
||||
暂定品级分组：黄阶高级（用户指定重要性暂定）。
|
||||
|
||||
### faqi-skill-seekers
|
||||
|
||||
Skill Seekers程序：指固定submodule修订的软件实现；多个CLI入口及可选MCP模块不机械复制产品身份。3.5.1仅为pyproject源码声明，不是已核发布或运行版。
|
||||
实现来源 `S16`，佐证来源 `S14, S15`；声明版本：3.5.1（仅源码声明）。
|
||||
暂定品级分组：玄阶中级（用户指定重要性暂定）。
|
||||
|
||||
### faqi-oh-my-tmux
|
||||
|
||||
oh-my-tmux可执行配置程序：配置文件含run、cut|sh调用链及可执行shell指令，按实际程序内容归software-artifact，不能仅因.conf后缀归纯规约；不是tmux本身。
|
||||
实现来源 `S18`，佐证来源 `S17, S19`；声明版本：未核/无明确发布版本声明。
|
||||
暂定品级分组：黄阶中级（用户指定重要性暂定）。
|
||||
|
||||
### faqi-tmux
|
||||
|
||||
tmux终端复用程序：指固定源码修订的程序内容，不是物理终端、pane、socket地址或一次会话。Git describe的邻近tag不作为已核发布版本。
|
||||
实现来源 `S21`，佐证来源 `S20`；声明版本：未核/无明确发布版本声明。
|
||||
暂定品级分组：黄阶高级（用户指定重要性暂定）。
|
||||
|
||||
### faqi-claude-skill-init
|
||||
|
||||
官方Skill初始化脚本：只纳入skill-creator下生成目录/模板的独立Python程序，不把官方Skill集合、自然语言方法、模板或其他全部辅助脚本称作同一程序。
|
||||
实现来源 `S23`，佐证来源 `S22`；声明版本：未核/无明确发布版本声明。
|
||||
暂定品级分组：玄阶初级（用户指定重要性暂定）。
|
||||
|
||||
## 按本次范围排除的本地程序所指
|
||||
|
||||
@@ -973,5 +1129,5 @@ make check-faqi-catalog
|
||||
make test-faqi-catalog
|
||||
```
|
||||
|
||||
检查复用jsonschema/PyYAML，表格复用tabulate；来源、ID、选区、范围或只读视图漂移均失败，不联网补证或静默升级。
|
||||
此初审不维护等级、账户、设备、部署或运行证据。独立语义审查、运行/效果/许可核验、产品同一/版本演化及未逐模块展开的复合包仍待核。
|
||||
检查复用jsonschema/PyYAML，表格复用tabulate；依赖图、来源、ID、选区、范围或只读视图漂移均失败，不联网补证或静默升级。
|
||||
本表未批准独立审查、完整运行/效果、许可、部署、账户或硬件身份。重要性分级与正式效能评价分轴；任务合同、阈值校准、运行版与源码身份桥接及通用图节点的落地实例仍待核。
|
||||
|
||||
Reference in New Issue
Block a user