gavindiaz/vibe-coding-cn
1
0
Fork 0
mirror of https://github.com/tradecatlabs/vibe-coding-cn.git synced 2026-11-02 13:06:13 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
d33714fdd3375b2413180120457ae553d64e26b7
vibe-coding-cn/.github/context/faqi/README.md
T
tradecatlabsandGitHub d33714fdd3 chore: extensions - 移除点名的八项程序与资料 (#158) 
* refactor: toolbox - 收口Context Skills Extensions三域资源

* fix: toolbox - 重定向文集中的嵌套标签链接

* fix: toolbox - 保全被ignore遮蔽的原跟踪事实文件

* refactor: toolbox - 退役workflows残留并平铺原定义

* docs: gongfa - 整理Lambda演算正文并冻结首发来源

* docs: gongfa - 登记Lambda演算天级上品并紧随拼好码

* docs: gongfa - 同步Lambda演算AI引用覆盖

* docs: readme - 移除工具箱怎么用整块

* refactor: skills - 删除16个官方引用仅保留自有入口

* refactor: extensions - 退役33个Skill脚本并清理调用

* refactor: maintenance - 迁移校验测试至.github维护层

* chore: extensions - 移除用户点名的八项程序与资料
2026-10-18 12:18:01 +08:00

188 lines
20 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!-- generated: sync-faqi-catalog.py -->
# Vibe Coding法器重要性总表
## 字多不看
品级仅表示 Vibe Coding 重要性暂定，不代表效能验证；原始登记、来源及历史见[data.json](data.json)。
历史来源初审与当前迁移位置分开；目录重构不产生新的运行、许可或效果批准。
## 快速导航
- [法器总表](#法器总表)
- [原始说明](#原始说明)
<details>
<summary><strong>完整细粒度目录（点击展开/收起）</strong></summary>
- [法器总表](#法器总表)
- [原始说明](#原始说明)
- [faqi-system](#doc-faqi-system)
- [vibe-coding-法器体系说明](#doc-faqi-system-vibe-coding-法器体系说明)
- [一句话](#doc-faqi-system-一句话)
- [字多不看](#doc-faqi-system-字多不看)
- [对象边界](#doc-faqi-system-对象边界)
- [重要性分级](#doc-faqi-system-重要性分级)
- [重要性与效能评级](#doc-faqi-system-重要性与效能评级)
- [选用流程](#doc-faqi-system-选用流程)
- [skill-seekers-mcp-static-review](#doc-faqi-system-skill-seekers-mcp-static-review)
- [固定源码复核skill-seekers-mcp](#doc-faqi-system-固定源码复核skill-seekers-mcp)
- [登记与维护](#doc-faqi-system-登记与维护)
</details>
## 使用方式
原始数据只在data.json维护；运行make sync-faqi-catalog更新本文件。
## 正文
## 法器总表
| 品级 | 名称 | 解释 |
|:---------|:----------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------|
| 天阶高级 | 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编码有替代路径；本级只表达工作流重要性，不评价实现质量或效能。 |
| 黄阶高级 | tmux终端复用程序 | Vibe Coding重要性：可选的多会话终端复用；支持持久终端与多窗口工作流，复杂长任务可受益；普通编码闭环有替代方案，不属定义性核心。 |
| 黄阶中级 | oh-my-tmux可执行配置程序 | Vibe Coding重要性：终端复用器体验配置；改善tmux使用便利性，但不提供模型推理或核心代码执行能力，可由其他终端配置替代。 |
| 黄阶初级 | 提示词格式转换程序 | Vibe Coding重要性：提示词资产格式迁移的辅助支路；只负责格式转换，能维护和复用提示词资产但不参与模型推理或代码执行；替代方式多，属低重要性辅助。 |
## 原始说明
> 文集保留历史正文；已退役实现的相关链接指向已发布的固定Git修订，不是当前安装或运行入口。现存程序以Extensions清单为准。
<a id="doc-faqi-system"></a>
## Vibe Coding 法器体系说明
原始文集：`.github/docs/gongfa/faqi-system.md`；下文为阅读呈现，原字节和来源保存在[data.json](data.json)。
<a id="doc-faqi-system-vibe-coding-法器体系说明"></a>
**Vibe Coding 法器体系说明**
本文说明法器总表的对象边界、重要性分级和维护入口；具体来源事实与逐条分组以登记源和生成总表为准。
<a id="doc-faqi-system-一句话"></a>
**一句话**
法器总表整理 Vibe Coding 流程中使用或依赖的工具、可调用入口及依赖类别，帮助读者理解它们在工作流中的位置。品级按对 Vibe Coding 的重要性暂定，不代表工具质量、运行可用性或任务效果。
<a id="doc-faqi-system-字多不看"></a>
**字多不看**
- 当前实现退役补充：用户点名的chat-vault、my-nvim、codex-config、MCPlayerTransfer、XHS-image-to-PDF-conversion、两个xhs图文HTML及html-tools-main说明共8项已移除。对应当前路径和实现绑定已清理；原来源、选区、初审、排除与重要性保留为历史，不表示Codex安装器或这些旧工具仍可使用。
- 当前实现退役：原auto-skill模板生成/结构校验、Skill Seekers本地适配和auto-tmux命令封装已经从Extensions移除。原30项重要性及固定来源初审保留为历史，不表示这些旧程序当前可执行；两个Skill改用原生工具与规范指令，独立初始化器和锁定上游继续保留。
- 方法和能力要求归功法；工具、软件入口及依赖类别按其真实所指另行整理，不因出现在同一依赖图就变成同一种对象。
- 当前 30 项按重要性分为天阶 4 项、地阶 12 项、玄阶 9 项、黄阶 5 项；品级、名称、重要性范围与分级依据见[法器浏览表](#法器总表)，完整登记见[法器登记源](data.json)。
- 天阶强调模型推理与 Agent 协作；地阶强调代码操作、工具执行和运行基础；玄阶强调上下文、验证、复用与产品交付；黄阶强调可替代的专用或便利能力。
- 每阶高级、中级、初级表示该阶内的重要性次序，不是测试结果带或效能等级。
- 当前重要性分级与正式任务效果评级是两条独立轴；正式效能量表仍为 draft，阈值尚未校准。
<a id="doc-faqi-system-对象边界"></a>
**对象边界**
“法器”是本项目用于组织 Vibe Coding 工具与依赖能力的领域称呼，不等同于某个统一产品类别。登记必须按具体所指区分程序内容、当前运行实例、模型制品、服务/API、硬件资源、候选对象和抽象依赖类别。
总表中的不同记录不能仅凭名称、依赖图位置或功能相似而合并：
- **来源限定实现**：绑定选定的仓内来源和代码内容，不自动代表本机运行版本。
- **运行实例或具名候选**：记录实际观察到的入口，或依赖图中指向的候选；候选身份、版本和来源可能仍待核。
- **依赖类别**：例如模型服务、CI 平台、终端接口或检索记忆。用户确认类别纳入范围，不等于确认了某个产品、部署、账号或可用实现。
- **外部资源行**：索引原资源记录，不等同于一件独立法器，也不单独证明能力、许可或运行效果。
法器不替代功法、任务合同或权限。建议使用某种工具，不代表它是唯一依赖、已获授权或已通过验证；执行一个过程也不自动证明预期效果。
<a id="doc-faqi-system-重要性分级"></a>
**重要性分级**
本次排序面向一般 Vibe Coding 工作流，综合考虑条目在核心闭环中的作用、对代码执行和验证的支撑程度、适用范围及可替代性。分级是用户确认的导航性判断，并非从版本新旧、依赖图深度、代码规模或烟测结果计算出来的分数。
| 品级方向 | 重要性含义 | 常见角色 |
|---|---|---|
| 天阶 | 决定核心 AI 协作链能否成立 | 模型推理、Agent 运行与编排 |
| 地阶 | 支撑代码真正被操作、运行和管理 | 终端命令、PTY、版本控制、语言与运行环境 |
| 玄阶 | 扩展复杂任务的上下文、质量和交付范围 | 检索记忆、自动验证、技能复用、部署与数据集成 |
| 黄阶 | 对特定工作方式有帮助，但通常存在替代路径 | 多会话终端、专用适配与格式转换 |
同阶内按高级、中级、初级表示重要性由高到低。等级只表示相对工作流位置：某项黄阶工具仍可能是某个具体任务的必要条件；高阶条目也不因此成为质量更好或已经可用的产品。
浏览表列品级、名称、重要性范围和分级依据；当前明细及每项完整登记以[登记源](data.json)为准。登记中的 10 项来源限定实现、13 条本地路径记录、12 项依赖图具名对象/运行观察和 8 项用户确认的依赖类别属于不同计数视角；依赖图另有 9 条本地关联，只表达关系、不重复计作对象；本地范围排除另有 9 条。158 条外部资源行也不等同于 158 件法器。
<a id="doc-faqi-system-重要性与效能评级"></a>
**重要性与效能评级**
| 维度 | 回答的问题 | 当前状态 |
|---|---|---|
| 重要性分级 | 该工具或类别在 Vibe Coding 工作流中有多关键、可由什么替代？ | 已按用户要求形成暂定排序，见法器总表。 |
| 正式效能评级 | 某一固定实现、版本和任务环境是否达到明确效果合同？ | 量表仍为 draft；任务合同、基线和阈值未校准，当前没有正式效能结论。 |
来源审查、版本观察、静态阅读或单次烟测都不能替代固定任务合同和可复核的效果证据。登记状态也不等于独立审查、运行验证、许可证批准或安全授权。正式效能规约及证据条件见[统一本体中的法器品级规约](../gongfa/README.md#doc-cultivation-ontology-taxonomy-法器品级规约)。
<a id="doc-faqi-system-选用流程"></a>
**选用流程**
1. 先定义要完成的任务、验收条件、环境和权限边界，不从最高品级反推工具选择。
2. 从总表识别可能的工具或依赖类别，再核实具体实现、来源、版本和可用性；抽象类别不能直接当成已安装产品。
3. 检查数据、网络、外部副作用、许可和恢复方式。类别纳入或版本观察不构成批准。
4. 在适用任务中运行有界验证，保留成功与失败证据；验证范围不得超过实际测试的输入和环境。
5. 若要提出正式效能评级，另按固定任务合同、合理基线、校准阈值和可复核结果评定，不沿用本页的重要性分组。
<a id="doc-faqi-system-skill-seekers-mcp-static-review"></a>
<a id="doc-faqi-system-固定源码复核skill-seekers-mcp"></a>
**固定源码复核：Skill Seekers MCP**
2026-10-16对固定 pin `26638b248279a3b001b651475e0f28975f5ff069` 新增 S66–S73 支持选区，
完整路径、一基半开行号、文件及选区 SHA 见[登记源](data.json)。这些仍支持同一件程序，不新增运行实例或品级。
- **入口与版本**：兼容入口转交 FastMCP；是否实际加载取决于依赖和运行环境。头注释写34个工具，静态可见40个装饰函数，
health 返回版本字符串2.1.1；它们不等于运行工具清单，也不能替代 pyproject 的3.5.1源码声明或实际版本核验。
- **监听与授权**：默认 stdio，HTTP 默认 `127.0.0.1:8000`；选区启用通配 CORS。
回环地址只限制默认监听范围，CORS 不是身份认证或调用授权，不能据此断言服务已安全隔离。
- **打包与凭据**：package 默认允许在存在平台密钥时上传；upload 的显式密钥会进入 `--api-key` 子进程参数，
Popen 没有显式收窄继承环境。这是源码风险线索，不是已观察到密钥泄露；本轮没有读取实际凭据。
- **副作用与预览**：install 还编排抓取、AI增强、打包、条件上传及独立 marketplace 发布。
`auto_upload=False` 不关闭前序步骤或发布支路；scrape_docs 在 unlimited 模式先写临时配置，不能把 dry_run 声明理解为零 I/O。
部分输出使用成功字符串或路径回退，不等于阶段完成、产物存在及外部效果均被独立核实。
- **结论边界**：本轮未导入或执行被审程序、启服务、抓取、上传或安装。
数据来源授权、认证、下游调用、环境隔离、超时/取消、异常清理和恢复仍待独立验证；不提升运行、效果、独立审查或许可批准状态。
<a id="doc-faqi-system-登记与维护"></a>
**登记与维护**
- [法器登记源](data.json)是唯一可编辑总登记；字段边界见[Schema](data.json)。
- [法器浏览表](#法器总表)由登记源生成，仅列品级、名称和解释；解释展示重要性范围与分级依据，完整字段以[法器登记源](data.json)及各来源所有者的数据为准，不手工编辑。
- 外部资源的原始名称、地址、状态和风险仍由[外部资源登记](../external-resources/README.md)维护。
- 正文类型及正式效能规约以[修仙领域统一本体](../gongfa/README.md#doc-cultivation-ontology-taxonomy)为准；本页不另建分类树或实现身份库。
更新登记或生成视图时使用：
```bash
make sync-faqi-catalog
make check-faqi-catalog
make test-faqi-catalog
```
Reference in New Issue View Git Blame Copy Permalink