gavindiaz/vibe-coding-cn
1
0
Fork 0
mirror of https://github.com/tradecatlabs/vibe-coding-cn.git synced 2026-11-02 10:46:29 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: faqi catalog - expand explanations

Browse Source
This commit is contained in:
tradecatlabs
2026-10-12 17:45:34 +08:00
committed by GitHub
parent 892ce37d33
commit 46a00a6051
8 changed files with 42 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files
AGENTS.md
+2 -2
View File
@@ -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 聊天记录保存工具
@@ -259,7 +259,7 @@ git push origin develop
- `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` - 法器总分类登记及字段契约；复用本体类型、固定来源审查、依赖图对象和用户确认纳入的依赖类别，原资源事实仍归资源YAML；当前暂定品级按Vibe Coding重要性分组，正式效能评级仍须独立效果证据。
- `tools/faqi-catalog.md` - 法器品级、名称与解释的三列只读浏览表；完整登记与分组依据归`metadata/faqi.json`，资源原事实仍归资源YAML。
- `tools/faqi-catalog.md` - 法器品级、名称与详细解释的三列只读浏览表；解释合并重要性范围和分级依据，完整登记仍归`metadata/faqi.json`，资源原事实归资源YAML。
- `scripts/sync-faqi-catalog.py` / `test-faqi-catalog.py` - 离线总表生成、检查及行为契约；核来源、图SHA、对象映射和品级边界，保留真实命令/结果；不执行被审程序或联网补证。
- `metadata/gongfa/registry.json` - 活跃功法登记、等级、规则、来源、内容版本、人工初评及正式评级历史的唯一可编辑数据源；类型语义仍归本体主文；新范围追加批次
- `metadata/gongfa/catalog.md` / `catalog.xlsx` - 功法总表的生成视图；Markdown列品级、名称与详细解释：登记摘要/问题/机制及条件/限制/预期结果，候选原文/用途/理由，Solve机制/适用范围/前提/边界；完整原始数据仍归JSON；Excel保留完整字段；不手改、不自动注册/去重/评级
docs/gongfa/faqi-system.md
+3 -3
View File
@@ -9,7 +9,7 @@
## 字多不看
- 方法和能力要求归功法；工具、软件入口及依赖类别按其真实所指另行整理，不因出现在同一依赖图就变成同一种对象。
- 当前 30 项按重要性分为天阶 4 项、地阶 12 项、玄阶 9 项、黄阶 5 项；品级、名称与简要解释见[法器浏览表](../../tools/faqi-catalog.md)，详细登记与分组依据见[法器登记源](../../metadata/faqi.json)。
- 当前 30 项按重要性分为天阶 4 项、地阶 12 项、玄阶 9 项、黄阶 5 项；品级、名称、重要性范围与分级依据见[法器浏览表](../../tools/faqi-catalog.md)，完整登记见[法器登记源](../../metadata/faqi.json)。
- 天阶强调模型推理与 Agent 协作；地阶强调代码操作、工具执行和运行基础；玄阶强调上下文、验证、复用与产品交付；黄阶强调可替代的专用或便利能力。
- 每阶高级、中级、初级表示该阶内的重要性次序，不是测试结果带或效能等级。
- 当前重要性分级与正式任务效果评级是两条独立轴；正式效能量表仍为 draft，阈值尚未校准。
@@ -40,7 +40,7 @@
同阶内按高级、中级、初级表示重要性由高到低。等级只表示相对工作流位置：某项黄阶工具仍可能是某个具体任务的必要条件；高阶条目也不因此成为质量更好或已经可用的产品。
浏览表列品级、名称与简要解释；当前明细及每项分组理由以[登记源](../../metadata/faqi.json)为准。登记中的 10 项来源限定实现、12 项依赖图具名对象/运行观察和 8 项用户确认的依赖类别属于不同视角；9 条本地实现关联只是关联记录，不应重复计作新对象。158 条外部资源行也不等同于 158 件法器。
浏览表列品级、名称、重要性范围和分级依据；当前明细及每项完整登记以[登记源](../../metadata/faqi.json)为准。登记中的 10 项来源限定实现、12 项依赖图具名对象/运行观察和 8 项用户确认的依赖类别属于不同视角；9 条本地实现关联只是关联记录，不应重复计作新对象。158 条外部资源行也不等同于 158 件法器。
## 重要性与效能评级
@@ -62,7 +62,7 @@
## 登记与维护
- [法器登记源](../../metadata/faqi.json)是唯一可编辑总登记；字段边界见[Schema](../../metadata/faqi.schema.json)。
- [法器浏览表](../../tools/faqi-catalog.md)由登记源生成，仅列品级、名称和解释；详细字段以[法器登记源](../../metadata/faqi.json)及各来源所有者的数据为准，不手工编辑。
- [法器浏览表](../../tools/faqi-catalog.md)由登记源生成，仅列品级、名称和解释；解释展示重要性范围与分级依据，完整字段以[法器登记源](../../metadata/faqi.json)及各来源所有者的数据为准，不手工编辑。
- 外部资源的原始名称、地址、状态和风险仍由[外部资源登记](../../assets/external-resources/README.md)维护。
- 正文类型及正式效能规约以[修仙领域统一本体](cultivation-ontology-taxonomy.md)为准；本页不另建分类树或实现身份库。
scripts/AGENTS.md
+1 -1
View File
@@ -34,7 +34,7 @@
## 法器总分类维护
- `sync-faqi-catalog.py`复用jsonschema/PyYAML/tabulate，读取总分类JSON、固定来源与外部资源YAML，校验依赖图SHA及对象映射，只维护`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与一基半开选区；来源/输入/输出软链接、未知字段、漏/重资源、越界/超限与并行漂移非零失败。
scripts/sync-faqi-catalog.py
+1 -1
View File
@@ -334,7 +334,7 @@ def render(data, objects):
**{item["id"]: item["node"] for item in graph["dependency_categories"]},
}
rows = [
[GRADE_LABELS[item["grade_id"]], names[item["subject_id"]], item["basis"]]
[GRADE_LABELS[item["grade_id"]], names[item["subject_id"]], item["scope"] + "；" + item["basis"]]
for item in sorted(assignments, key=lambda item: (grade_order[item["grade_id"]], item["subject_id"]))
]
out = [
scripts/test-faqi-catalog.py
+1 -1
View File
@@ -90,7 +90,7 @@ class FaqiCatalogTest(unittest.TestCase):
tbody_start = next(index for index in range(thead_end + 1, len(tokens)) if tokens[index].type == "tbody_open")
tbody_end = next(index for index in range(tbody_start + 1, len(tokens)) if tokens[index].type == "tbody_close")
self.assertEqual(len(assignments), sum(token.type == "tr_open" for token in tokens[tbody_start:tbody_end]))
self.assertIn(assignments[0]["basis"], catalog)
self.assertIn(assignments[0]["scope"] + "；" + assignments[0]["basis"], 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, "父仓库来源不在已发布主线历史可达")
tools/AGENTS.md
+1 -1
View File
@@ -8,7 +8,7 @@
- `tools/prompts-library/`：提示词 Excel、Markdown、JSONL 转换工具。
- `tools/chat-vault/`：AI 聊天记录保存工具。
- `tools/external/`：第三方工具、外部仓库和 Git submodule。
- `faqi-catalog.md`：法器重要性只读浏览表，仅含“品级、名称、解释”三列；详细登记归`metadata/faqi.json`，原资源字段仍归资源YAML。
- `faqi-catalog.md`：法器重要性只读浏览表，仅含“品级、名称、解释”三列；解释合并登记的范围与分级依据，完整登记归`metadata/faqi.json`，原资源字段仍归资源YAML。
## 约束
tools/README.md
+1 -1
View File
@@ -8,7 +8,7 @@
- `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)：法器重要性只读浏览表，仅展示“品级、名称、解释”三列；解释合并重要性范围和分级依据，完整登记归[metadata/faqi.json](../metadata/faqi.json)，原资源字段仍归资源YAML。
## 法器总表维护
tools/faqi-catalog.md
+32 -32
View File
@@ -3,35 +3,35 @@
品级仅表示 Vibe Coding 重要性暂定，不代表效能验证；本页仅供浏览，完整登记见[metadata/faqi.json](../metadata/faqi.json)。
| 品级 | 名称 | 解释 |
|:---------|:----------------------------------------------------------|:----------------------------------------------------------------------------------------------------------------|
| 天阶高级 | 2.2 云端模型服务/API与固定模型版本 | 提供理解需求、推理和生成代码的核心智能能力；没有模型推理路径即失去Vibe Coding的定义性特征，供应商与模型可替换。 |
| 天阶高级 | Pi Agent CLI（当前 PATH 实例） | 直接承接需求、上下文、模型调用和工具执行循环；当前环境的核心交互入口，缺失会改变Vibe Coding核心形态。 |
| 天阶中级 | 2.2 本地模型权重、Tokenizer与推理引擎 | 可提供核心模型推理并支持本地化、隐私或离线需求；在通用工作流中可由云端推理替代，故低于定义性核心路径。 |
| 天阶中级 | Codex CLI（依赖图替代项） | 若选用可承担AI代码协作与工具编排核心；当前仅具名候选且可与其他运行时替换，低于已用核心路径。 |
| 地阶高级 | GNU Bash | 直接承接终端命令、开发脚本和验证操作，是当前Agent落地代码动作的高重要性接口；Shell实现可替代但该角色不可缺。 |
| 地阶高级 | 3.2 Terminal Emulator / PTY | 把Agent计划转成真实文件、构建和测试操作的关键执行边界；没有等价工具执行通道，代码闭环无法完成。 |
| 地阶高级 | Git 本地客户端 | 支撑审查AI改动、保留版本历史和安全回退，是可维护代码生成闭环的高重要性基础；版本控制实现可替代。 |
| 地阶中级 | 8 CPU/GPU、内存、存储、网络、电力与数据中心 | 为模型调用、代码执行及数据交换提供资源底座；实现可跨云、主机和本地环境替换，故不是单一核心产品。 |
| 地阶中级 | 4.2 包注册表、Git源与可信缓存 | 支持安装成熟组件、解析代码依赖和重建开发环境；具体注册表与来源有替代，不直接承担AI生成。 |
| 地阶中级 | Node.js 运行时 | 支撑前端、Node项目和本仓Markdown工具链；具体语言环境可替代，重要性低于通用Agent与终端执行核心。 |
| 地阶中级 | npm / npx 工具 | 让Node生态依赖和命令行工具可安装、解析与调用；作用范围依赖项目技术栈，可由其他生态包管理器替代。 |
| 地阶中级 | Python 运行时 | 支撑本仓工具及大量Python项目的执行和验证；语言运行时可按项目替代，重要但非所有Vibe Coding任务必需。 |
| 地阶初级 | GNU Make | 把构建和验证命令组织成可重复入口有助于交付，但Make可由其他任务运行器或脚本替代。 |
| 地阶初级 | Ubuntu 用户空间发行版 | 承载当前工具链和本地命令，但同类操作系统环境可以替代，重要性来自运行基座而非该发行版身份。 |
| 地阶初级 | WSL2 Linux 内核 | 提供当前WSL用户空间的执行底座，但存在其他内核和宿主替代，不属于AI编程核心能力。 |
| 地阶初级 | WSL 2 承载平台 | 为当前工具链提供运行宿主，但Linux、macOS或原生Windows等环境可替代，不是Vibe Coding定义性能力。 |
| 玄阶高级 | 7.1 Git托管、CI Runner与CI/CD平台 | 把代码生成接入可重复测试、审查和协作交付，显著扩展可靠使用范围；本地闭环可运行但难以替代团队级持续验证。 |
| 玄阶高级 | 2.3 检索/索引/记忆与向量库 | 支撑跨文件和长任务上下文保持、历史知识复用，提升复杂任务可处理范围；短任务仍可不依赖，且实现可替换。 |
| 玄阶中级 | 7.2-7.3 制品注册表、部署目标、产品运行时、数据库与外部API | 支撑部署、数据库和API集成，使代码进入真实产品场景；并非每次编码必需，故属于重要交付扩展而非核心生成。 |
| 玄阶中级 | auto-skill模板生成脚本 | 把操作知识封装为可复用Agent技能，能扩展后续任务能力；属于增益支路，不是最小编码闭环的必需组件。 |
| 玄阶中级 | auto-skill结构校验脚本 | 降低扩展技能结构错误造成的接入阻断；不判断语义正确性，属于能力扩展的质量辅助。 |
| 玄阶中级 | Skill Seekers程序 | 增加Agent可复用的领域能力和上下文资产；需特定工作流，不能替代通用推理与工具执行。 |
| 玄阶初级 | 官方Skill初始化脚本 | 降低Claude Skill结构初始化成本，作用范围绑定特定生态，可手工完成且不影响其他Agent的基础闭环。 |
| 玄阶初级 | Codex配置安装与恢复脚本 | 降低特定Agent初始配置成本，但只服务候选运行时且可手工替代；不属于核心模型推理或执行闭环。 |
| 玄阶初级 | Skill Seekers本地运行适配脚本 | 便于调用特定知识转技能工具；范围受上游工具限制，可直接调用或人工替代。 |
| 黄阶高级 | tmux 当前运行实例 | 可持久化和并行组织终端工作，复杂协作时有价值；普通单会话开发可替代，不属于核心生成链。 |
| 黄阶高级 | auto-tmux命令封装程序 | 能管理多会话和worker工作流，复杂并行时有用；基础单Agent编码不依赖，且当前doctor烟测失败，重要性不等于实现质量。 |
| 黄阶高级 | tmux终端复用程序 | 支持持久终端与多窗口工作流，复杂长任务可受益；普通编码闭环有替代方案，不属定义性核心。 |
| 黄阶中级 | oh-my-tmux可执行配置程序 | 改善tmux使用便利性，但不提供模型推理或核心代码执行能力，可由其他终端配置替代。 |
| 黄阶初级 | 提示词格式转换程序 | 只负责格式转换，能维护和复用提示词资产但不参与模型推理或代码执行；替代方式多，属低重要性辅助。 |
| 品级 | 名称 | 解释 |
|:---------|:----------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------|
| 天阶高级 | 2.2 云端模型服务/API与固定模型版本 | Vibe Coding重要性：核心模型推理与代码生成；提供理解需求、推理和生成代码的核心智能能力；没有模型推理路径即失去Vibe Coding的定义性特征，供应商与模型可替换。 |
| 天阶高级 | Pi Agent CLI（当前 PATH 实例） | Vibe Coding重要性：当前核心Agent运行与工具编排；直接承接需求、上下文、模型调用和工具执行循环；当前环境的核心交互入口，缺失会改变Vibe Coding核心形态。 |
| 天阶中级 | 2.2 本地模型权重、Tokenizer与推理引擎 | Vibe Coding重要性：本地/离线模型推理路径；可提供核心模型推理并支持本地化、隐私或离线需求；在通用工作流中可由云端推理替代，故低于定义性核心路径。 |
| 天阶中级 | Codex CLI（依赖图替代项） | Vibe Coding重要性：替代Agent运行时；若选用可承担AI代码协作与工具编排核心；当前仅具名候选且可与其他运行时替换，低于已用核心路径。 |
| 地阶高级 | GNU Bash | Vibe Coding重要性：Agent命令执行与脚本交互；直接承接终端命令、开发脚本和验证操作，是当前Agent落地代码动作的高重要性接口；Shell实现可替代但该角色不可缺。 |
| 地阶高级 | 3.2 Terminal Emulator / PTY | Vibe Coding重要性：Agent调用工具与执行开发命令；把Agent计划转成真实文件、构建和测试操作的关键执行边界；没有等价工具执行通道，代码闭环无法完成。 |
| 地阶高级 | Git 本地客户端 | Vibe Coding重要性：代码变更追踪、比较与恢复；支撑审查AI改动、保留版本历史和安全回退，是可维护代码生成闭环的高重要性基础；版本控制实现可替代。 |
| 地阶中级 | 8 CPU/GPU、内存、存储、网络、电力与数据中心 | Vibe Coding重要性：计算、存储与网络承载；为模型调用、代码执行及数据交换提供资源底座；实现可跨云、主机和本地环境替换，故不是单一核心产品。 |
| 地阶中级 | 4.2 包注册表、Git源与可信缓存 | Vibe Coding重要性：依赖获取、锁定与复现；支持安装成熟组件、解析代码依赖和重建开发环境；具体注册表与来源有替代，不直接承担AI生成。 |
| 地阶中级 | Node.js 运行时 | Vibe Coding重要性：前端及工具链代码运行；支撑前端、Node项目和本仓Markdown工具链；具体语言环境可替代，重要性低于通用Agent与终端执行核心。 |
| 地阶中级 | npm / npx 工具 | Vibe Coding重要性：Node依赖解析与工具调用；让Node生态依赖和命令行工具可安装、解析与调用；作用范围依赖项目技术栈，可由其他生态包管理器替代。 |
| 地阶中级 | Python 运行时 | Vibe Coding重要性：脚本、工具与项目代码运行；支撑本仓工具及大量Python项目的执行和验证；语言运行时可按项目替代，重要但非所有Vibe Coding任务必需。 |
| 地阶初级 | GNU Make | Vibe Coding重要性：可重复构建与检查入口；把构建和验证命令组织成可重复入口有助于交付，但Make可由其他任务运行器或脚本替代。 |
| 地阶初级 | Ubuntu 用户空间发行版 | Vibe Coding重要性：当前Linux用户空间；承载当前工具链和本地命令，但同类操作系统环境可以替代，重要性来自运行基座而非该发行版身份。 |
| 地阶初级 | WSL2 Linux 内核 | Vibe Coding重要性：当前运行环境内核；提供当前WSL用户空间的执行底座，但存在其他内核和宿主替代，不属于AI编程核心能力。 |
| 地阶初级 | WSL 2 承载平台 | Vibe Coding重要性：当前宿主环境实现；为当前工具链提供运行宿主，但Linux、macOS或原生Windows等环境可替代，不是Vibe Coding定义性能力。 |
| 玄阶高级 | 7.1 Git托管、CI Runner与CI/CD平台 | Vibe Coding重要性：自动化验证、协作与持续交付；把代码生成接入可重复测试、审查和协作交付，显著扩展可靠使用范围；本地闭环可运行但难以替代团队级持续验证。 |
| 玄阶高级 | 2.3 检索/索引/记忆与向量库 | Vibe Coding重要性：长程上下文、知识检索与记忆；支撑跨文件和长任务上下文保持、历史知识复用，提升复杂任务可处理范围；短任务仍可不依赖，且实现可替换。 |
| 玄阶中级 | 7.2-7.3 制品注册表、部署目标、产品运行时、数据库与外部API | Vibe Coding重要性：从代码到产品运行与外部集成；支撑部署、数据库和API集成，使代码进入真实产品场景；并非每次编码必需，故属于重要交付扩展而非核心生成。 |
| 玄阶中级 | auto-skill模板生成脚本 | Vibe Coding重要性：技能资产扩展与复用；把操作知识封装为可复用Agent技能，能扩展后续任务能力；属于增益支路，不是最小编码闭环的必需组件。 |
| 玄阶中级 | auto-skill结构校验脚本 | Vibe Coding重要性：技能资产质量与可载入性；降低扩展技能结构错误造成的接入阻断；不判断语义正确性，属于能力扩展的质量辅助。 |
| 玄阶中级 | Skill Seekers程序 | Vibe Coding重要性：外部知识转可复用技能；增加Agent可复用的领域能力和上下文资产；需特定工作流，不能替代通用推理与工具执行。 |
| 玄阶初级 | 官方Skill初始化脚本 | Vibe Coding重要性：特定Skill模板初始化；降低Claude Skill结构初始化成本，作用范围绑定特定生态，可手工完成且不影响其他Agent的基础闭环。 |
| 玄阶初级 | Codex配置安装与恢复脚本 | Vibe Coding重要性：特定Agent接入配置；降低特定Agent初始配置成本，但只服务候选运行时且可手工替代；不属于核心模型推理或执行闭环。 |
| 玄阶初级 | Skill Seekers本地运行适配脚本 | Vibe Coding重要性：Skill Seekers本地适配入口；便于调用特定知识转技能工具；范围受上游工具限制，可直接调用或人工替代。 |
| 黄阶高级 | tmux 当前运行实例 | Vibe Coding重要性：长任务与多会话终端复用；可持久化和并行组织终端工作，复杂协作时有价值；普通单会话开发可替代，不属于核心生成链。 |
| 黄阶高级 | auto-tmux命令封装程序 | Vibe Coding重要性：多会话终端协作自动化；能管理多会话和worker工作流，复杂并行时有用；基础单Agent编码不依赖，且当前doctor烟测失败，重要性不等于实现质量。 |
| 黄阶高级 | tmux终端复用程序 | Vibe Coding重要性：可选的多会话终端复用；支持持久终端与多窗口工作流，复杂长任务可受益；普通编码闭环有替代方案，不属定义性核心。 |
| 黄阶中级 | oh-my-tmux可执行配置程序 | Vibe Coding重要性：终端复用器体验配置；改善tmux使用便利性，但不提供模型推理或核心代码执行能力，可由其他终端配置替代。 |
| 黄阶初级 | 提示词格式转换程序 | Vibe Coding重要性：提示词资产格式迁移的辅助支路；只负责格式转换，能维护和复用提示词资产但不参与模型推理或代码执行；替代方式多，属低重要性辅助。 |