mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-11-02 13:56:57 +00:00
tradecatlabsandGitHub
83071f9c58
1026-VBCN：发布413条功法、30条法器的新增v2术语内容及305条工作性定义修订。 冻结原文、书目、对象身份和评级历史保留；123项相关测试及文档检查通过。未新增独立语义审核或工具运行效果证明；远端Actions已退役。
252 lines
87 KiB
Markdown
252 lines
87 KiB
Markdown
<!-- generated: sync-faqi-catalog.py -->
|
||
# Vibe Coding法器重要性总表：玄阶
|
||
|
||
本页包含9项玄阶对象。分级仅表示重要性暂定，不代表效能验证。
|
||
- [返回总索引](README.md)；其他阶：[天阶](tian.md)、[地阶](di.md)、[黄阶](huang.md)
|
||
|
||
## 玄阶对象
|
||
|
||
- [7.1 Git托管、CI Runner与CI/CD平台](#v0-faqi-dep-category-ci-platform-e3564493)
|
||
- [2.3 检索/索引/记忆与向量库](#v0-faqi-dep-category-retrieval-memory-da201109)
|
||
- [7.2-7.3 制品注册表、部署目标、产品运行时、数据库与外部API](#v0-faqi-dep-category-deployment-data-35c30956)
|
||
- [auto-skill模板生成脚本](#v0-faqi-faqi-auto-skill-create-ffe7ec4d)
|
||
- [auto-skill结构校验脚本](#v0-faqi-faqi-auto-skill-validate-5244b18f)
|
||
- [Skill Seekers程序](#v0-faqi-faqi-skill-seekers-cc1f7ed8)
|
||
- [官方Skill初始化脚本](#v0-faqi-faqi-claude-skill-init-3a642a5d)
|
||
- [Codex配置安装与恢复脚本](#v0-faqi-faqi-codex-config-installer-2dcddf43)
|
||
- [Skill Seekers本地运行适配脚本](#v0-faqi-faqi-skill-seekers-adapter-eb5e7e6f)
|
||
|
||
<a id="v0-faqi-dep-category-ci-platform-e3564493"></a>
|
||
### 7.1 Git托管、CI Runner与CI/CD平台
|
||
|
||
| 序号 | 说明项 | 内容 |
|
||
|:---:|:---|:---|
|
||
| 1 | 概念 | 承载代码协作、流水线执行与自动交付的服务类别 |
|
||
| 2 | 术语 | 7.1 Git托管、CI Runner与CI/CD平台 |
|
||
| 3 | 定义 | 工作性定义：一种涵盖Git托管、CI Runner与CI/CD平台，用于描述代码协作和自动构建验证交付基础能力的抽象依赖类别。 |
|
||
| 4 | 条目注释 | 编者注（据本条固定来源与既有说明归纳）：托管服务、Runner与CI/CD平台分别承担触发、执行和编排职责；本仓Actions仍停用，收录类别不表示重新启用。 |
|
||
| 5 | 来源 | 依赖类别来源与登记记录：{<br> "source_path": ".github/docs/gongfa/technology-stack.md",<br> "source_sha256": "88ff3494095c2a794acf130d5d2ccc4eb4b67ccdc8c174e7ef09f35c11a450a2",<br> "source_anchor": "reference-technology-stack-十六技术栈的层级结构",<br> "observed_at": "2026-10-10T12:14:00Z"<br>}<br>类别登记：{<br> "id": "dep-category-ci-platform",<br> "node": "7.1 Git托管、CI Runner与CI/CD平台",<br> "disposition": "user_confirmed_in_scope",<br> "reason": "用户确认此依赖类别已核并要求纳入；托管服务、Runner执行环境与CI/CD平台分开分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。"<br>}<br>重要性分级记录：{<br> "subject_id": "dep-category-ci-platform",<br> "grade_id": "faqi-xuan-advanced",<br> "assignment_status": "user_directed_provisional",<br> "scope": "Vibe Coding重要性：自动化验证、协作与持续交付",<br> "basis": "把代码生成接入可重复测试、审查和协作交付，显著扩展可靠使用范围；本地闭环可运行但难以替代团队级持续验证。"<br>}<br>类别纳入状态仅表示范围登记，不指向已部署的具体产品。 |
|
||
| 6 | 为什么 | 依赖图纳入该类别是为了表示“托管代码变更触发器、Runner和自动构建/验证工作流”这一系统能力层；它是用户确认范围内的抽象类别，不代表任一具体产品被采用。 |
|
||
| 7 | 怎么做 | 不适用：本条是抽象依赖类别，不指定唯一可执行产品、安装步骤或操作流程；具体实现需另行识别。 |
|
||
| 8 | 扩展 | 类别层只定义“托管代码变更触发器、Runner和自动构建/验证工作流”的边界；供应商、软件、版本、插件和部署属于具体实现或独立依赖对象，不作为本类别的默认扩展。 |
|
||
| 9 | 关联信息 | 本轮v2说明为编辑归纳；历史用户审阅仅对当时说明有效，不自动覆盖此次新增或改写内容。未新增独立审查、运行或效果证据。<br><br>原关联记录（含历史意见）：<br>依赖类别ID=dep-category-ci-platform；类别节点=7.1 Git托管、CI Runner与CI/CD平台；纳入状态=user_confirmed_in_scope。这是抽象类别，不是具体产品或运行实例。<br>Vibe Coding 重要性暂定：玄阶高级（grade_id=faqi-xuan-advanced；状态=user_directed_provisional）；范围：Vibe Coding重要性：自动化验证、协作与持续交付；分级依据：把代码生成接入可重复测试、审查和协作交付，显著扩展可靠使用范围；本地闭环可运行但难以替代团队级持续验证。不代表效能评级、运行结果或质量结论。<br>既有关系记录：未记录对象关系。 |
|
||
| 10 | 相关图书 | 本条是依赖图抽象类别，不是书目对象；来源是技术栈的架构节点定义（见第7项），不列产品文档为图书。 |
|
||
| 11 | 它要解决什么问题？ | 该类别覆盖的系统问题是：在工作流中提供“托管代码变更触发器、Runner和自动构建/验证工作流”所需的依赖位置。它不单独定义业务输入、结果或特定供应商的服务能力。 |
|
||
| 12 | 为什么这样设计？ | 不适用：该条是类别节点而非具名实现，当前材料不能支持具体设计选择解释。 |
|
||
| 13 | 内部如何实现？ | 不适用：抽象类别没有单一内部实现；不得以任一供应商/实现代表整个类别。 |
|
||
| 14 | 付出了什么代价？ | 该类别会带来与其组成相符的资源、身份、版本、权限和维护责任（Git托管、Runner OS/工具链、权限、验证脚本、制品签名/发布策略）；实际费用/性能随具体实现与工作负载变化，依赖图未提供测量。 |
|
||
| 15 | 比较不同技术与方法。 | 本地验证可替代部分CI执行但不提供同一触发/托管边界；不代表特定平台已配置。比较须固定任务、数据、权限、版本和预算；类别信息不支持供应商/产品排名。 |
|
||
| 16 | 提炼共同规律。 | 该类别可归纳的架构规则是：先区分托管代码变更触发器、Runner和自动构建/验证工作流与具体实现，再按任务选择并验证；类别纳入、依赖存在或调用成功都不证明能力效果。 |
|
||
| 17 | 明确这些规律成立的前提与适用条件。 | 类别依据（原记录）：用户确认此依赖类别已核并要求纳入；托管服务、Runner执行环境与CI/CD平台分开分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。<br>纳入状态：user_confirmed_in_scope；类别不是具体实现或部署。<br>若建立共同规律，须先核实同一问题、版本、环境、权限、协议及工作负载，并记录反例/不适用条件。 |
|
||
| 18 | 结论 | 结论（限第17项条件）：该类别可归纳的架构规则是：先区分托管代码变更触发器、Runner和自动构建/验证工作流与具体实现，再按任务选择并验证；类别纳入、依赖存在或调用成功都不证明能力效果。<br>非效果、许可或正式评级证明。 |
|
||
| 19 | 连接规则 | 推理桥梁：证据命题：登记把“7.1 Git托管、CI Runner与CI/CD平台”明确列作抽象依赖类别；第13项说明“抽象类别没有单一内部实现；不得以任一供应商/实现代表整个类别”，没有单一实现。类别范围见第5项/第20项。推理根据：类别描述的是职责/边界集合，不指定某个实现的接口、协议、权限或效果；同一类别中的具体实现须以各自证据判断。由于本条来源只支持分类与职责区分，没有绑定一个具名部署实例，因此第18项对“先区分托管代码变更触发器、Runner和自动构建/验证工作流与具体实现，再按任务选择并验证”的类别层架构归纳，不把它外推为具体产品能力或效果。成立边界：第17项限定为“类别依据（原记录）：用户确认此依赖类别已核并要求纳入；托管服务、Runner执行环境与CI/CD平台分开分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。 纳入状态：user_confirmed_in_scope；类别不是具体实现或部署。 若建立共同规律，须先核实同一问题、版本、环境、权限、协议及工作负载，并记录反例/不适用条件”；不据此外推未观察效果、许可或正式评级。 |
|
||
| 20 | 依据 | 依据：路径 `.github/docs/gongfa/technology-stack.md`；选区/锚点 `reference-technology-stack-十六技术栈的层级结构`；来源SHA-256 `88ff3494095c2a794acf130d5d2ccc4eb4b67ccdc8c174e7ef09f35c11a450a2`；第5项载完整出处；对应第13项，边界按第17项。快照/静态仅支持记录，不代表独立核验或效果/许可/评级证据。 |
|
||
|
||
<a id="v0-faqi-dep-category-retrieval-memory-da201109"></a>
|
||
### 2.3 检索/索引/记忆与向量库
|
||
|
||
| 序号 | 说明项 | 内容 |
|
||
|:---:|:---|:---|
|
||
| 1 | 概念 | 为按需信息访问提供检索、索引及记忆存储的依赖类别 |
|
||
| 2 | 术语 | 2.3 检索/索引/记忆与向量库 |
|
||
| 3 | 定义 | 工作性定义：一种涵盖文档或代码检索、索引、过滤、记忆及向量存储，用于描述按需信息访问能力的可选抽象依赖类别。 |
|
||
| 4 | 条目注释 | 编者注（据本条固定来源与既有说明归纳）：检索过程、索引、记忆内容与向量存储分别分类；向量库存在不证明检索相关性、权限隔离或用户记忆效果。 |
|
||
| 5 | 来源 | 依赖类别来源与登记记录：{<br> "source_path": ".github/docs/gongfa/technology-stack.md",<br> "source_sha256": "88ff3494095c2a794acf130d5d2ccc4eb4b67ccdc8c174e7ef09f35c11a450a2",<br> "source_anchor": "reference-technology-stack-十六技术栈的层级结构",<br> "observed_at": "2026-10-10T12:14:00Z"<br>}<br>类别登记：{<br> "id": "dep-category-retrieval-memory",<br> "node": "2.3 检索/索引/记忆与向量库",<br> "disposition": "user_confirmed_in_scope",<br> "reason": "用户确认此可选依赖类别已核并要求纳入；检索过程、索引、记忆内容与向量存储分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。"<br>}<br>重要性分级记录：{<br> "subject_id": "dep-category-retrieval-memory",<br> "grade_id": "faqi-xuan-advanced",<br> "assignment_status": "user_directed_provisional",<br> "scope": "Vibe Coding重要性：长程上下文、知识检索与记忆",<br> "basis": "支撑跨文件和长任务上下文保持、历史知识复用，提升复杂任务可处理范围；短任务仍可不依赖，且实现可替换。"<br>}<br>类别纳入状态仅表示范围登记，不指向已部署的具体产品。 |
|
||
| 6 | 为什么 | 依赖图纳入该类别是为了表示“按需提供文档/代码索引、检索、过滤、记忆与向量存储”这一系统能力层；它是用户确认范围内的抽象类别，不代表任一具体产品被采用。 |
|
||
| 7 | 怎么做 | 不适用：本条是抽象依赖类别，不指定唯一可执行产品、安装步骤或操作流程；具体实现需另行识别。 |
|
||
| 8 | 扩展 | 类别层只定义“按需提供文档/代码索引、检索、过滤、记忆与向量存储”的边界；供应商、软件、版本、插件和部署属于具体实现或独立依赖对象，不作为本类别的默认扩展。 |
|
||
| 9 | 关联信息 | 本轮v2说明为编辑归纳；历史用户审阅仅对当时说明有效，不自动覆盖此次新增或改写内容。未新增独立审查、运行或效果证据。<br><br>原关联记录（含历史意见）：<br>依赖类别ID=dep-category-retrieval-memory；类别节点=2.3 检索/索引/记忆与向量库；纳入状态=user_confirmed_in_scope。这是抽象类别，不是具体产品或运行实例。<br>Vibe Coding 重要性暂定：玄阶高级（grade_id=faqi-xuan-advanced；状态=user_directed_provisional）；范围：Vibe Coding重要性：长程上下文、知识检索与记忆；分级依据：支撑跨文件和长任务上下文保持、历史知识复用，提升复杂任务可处理范围；短任务仍可不依赖，且实现可替换。不代表效能评级、运行结果或质量结论。<br>既有关系记录：未记录对象关系。 |
|
||
| 10 | 相关图书 | 本条是依赖图抽象类别，不是书目对象；来源是技术栈的架构节点定义（见第7项），不列产品文档为图书。 |
|
||
| 11 | 它要解决什么问题？ | 该类别覆盖的系统问题是：在工作流中提供“按需提供文档/代码索引、检索、过滤、记忆与向量存储”所需的依赖位置。它不单独定义业务输入、结果或特定供应商的服务能力。 |
|
||
| 12 | 为什么这样设计？ | 不适用：该条是类别节点而非具名实现，当前材料不能支持具体设计选择解释。 |
|
||
| 13 | 内部如何实现？ | 不适用：抽象类别没有单一内部实现；不得以任一供应商/实现代表整个类别。 |
|
||
| 14 | 付出了什么代价？ | 该类别会带来与其组成相符的资源、身份、版本、权限和维护责任（索引来源、更新、权限过滤、检索器、缓存/存储及证据进入上下文的链路）；实际费用/性能随具体实现与工作负载变化，依赖图未提供测量。 |
|
||
| 15 | 比较不同技术与方法。 | 文档直读或搜索可作为替代/互补路径；索引存在不证明召回质量或证据被模型使用。比较须固定任务、数据、权限、版本和预算；类别信息不支持供应商/产品排名。 |
|
||
| 16 | 提炼共同规律。 | 该类别可归纳的架构规则是：先区分按需提供文档/代码索引、检索、过滤、记忆与向量存储与具体实现，再按任务选择并验证；类别纳入、依赖存在或调用成功都不证明能力效果。 |
|
||
| 17 | 明确这些规律成立的前提与适用条件。 | 类别依据（原记录）：用户确认此可选依赖类别已核并要求纳入；检索过程、索引、记忆内容与向量存储分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。<br>纳入状态：user_confirmed_in_scope；类别不是具体实现或部署。<br>若建立共同规律，须先核实同一问题、版本、环境、权限、协议及工作负载，并记录反例/不适用条件。 |
|
||
| 18 | 结论 | 结论（限第17项条件）：该类别可归纳的架构规则是：先区分按需提供文档/代码索引、检索、过滤、记忆与向量存储与具体实现，再按任务选择并验证；类别纳入、依赖存在或调用成功都不证明能力效果。<br>非效果、许可或正式评级证明。 |
|
||
| 19 | 连接规则 | 推理桥梁：证据命题：登记把“2.3 检索/索引/记忆与向量库”明确列作抽象依赖类别；第13项说明“抽象类别没有单一内部实现；不得以任一供应商/实现代表整个类别”，没有单一实现。类别范围见第5项/第20项。推理根据：类别描述的是职责/边界集合，不指定某个实现的接口、协议、权限或效果；同一类别中的具体实现须以各自证据判断。由于本条来源只支持分类与职责区分，没有绑定一个具名部署实例，因此第18项对“先区分按需提供文档/代码索引、检索、过滤、记忆与向量存储与具体实现，再按任务选择并验证”的类别层架构归纳，不把它外推为具体产品能力或效果。成立边界：第17项限定为“类别依据（原记录）：用户确认此可选依赖类别已核并要求纳入；检索过程、索引、记忆内容与向量存储分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。 纳入状态：user_confirmed_in_scope；类别不是具体实现或部署。 若建立共同规律，须先核实同一问题、版本、环境、权限、协议及工作负载，并记录反例/不适用条件”；不据此外推未观察效果、许可或正式评级。 |
|
||
| 20 | 依据 | 依据：路径 `.github/docs/gongfa/technology-stack.md`；选区/锚点 `reference-technology-stack-十六技术栈的层级结构`；来源SHA-256 `88ff3494095c2a794acf130d5d2ccc4eb4b67ccdc8c174e7ef09f35c11a450a2`；第5项载完整出处；对应第13项，边界按第17项。快照/静态仅支持记录，不代表独立核验或效果/许可/评级证据。 |
|
||
|
||
<a id="v0-faqi-dep-category-deployment-data-35c30956"></a>
|
||
### 7.2-7.3 制品注册表、部署目标、产品运行时、数据库与外部API
|
||
|
||
| 序号 | 说明项 | 内容 |
|
||
|:---:|:---|:---|
|
||
| 1 | 概念 | 承载制品交付与上线后应用数据服务的可选依赖类别 |
|
||
| 2 | 术语 | 7.2-7.3 制品注册表、部署目标、产品运行时、数据库与外部API |
|
||
| 3 | 定义 | 工作性定义：一种按上线交付场景涵盖制品注册表、部署目标、产品运行时、数据库及外部API的可选抽象依赖类别，各组成对象保留独立边界。 |
|
||
| 4 | 条目注释 | 编者注（据本条固定来源与既有说明归纳）：制品注册表、部署目标、产品运行时、数据库和外部API仍分开分类；类别存在不表示当前任务必须部署或已创建服务。 |
|
||
| 5 | 来源 | 依赖类别来源与登记记录：{<br> "source_path": ".github/docs/gongfa/technology-stack.md",<br> "source_sha256": "88ff3494095c2a794acf130d5d2ccc4eb4b67ccdc8c174e7ef09f35c11a450a2",<br> "source_anchor": "reference-technology-stack-十六技术栈的层级结构",<br> "observed_at": "2026-10-10T12:14:00Z"<br>}<br>类别登记：{<br> "id": "dep-category-deployment-data",<br> "node": "7.2-7.3 制品注册表、部署目标、产品运行时、数据库与外部API",<br> "disposition": "user_confirmed_in_scope",<br> "reason": "用户确认此可选依赖类别已核并要求纳入；注册表、部署环境、运行时、数据库与外部API分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。"<br>}<br>重要性分级记录：{<br> "subject_id": "dep-category-deployment-data",<br> "grade_id": "faqi-xuan-intermediate",<br> "assignment_status": "user_directed_provisional",<br> "scope": "Vibe Coding重要性：从代码到产品运行与外部集成",<br> "basis": "支撑部署、数据库和API集成，使代码进入真实产品场景；并非每次编码必需，故属于重要交付扩展而非核心生成。"<br>}<br>类别纳入状态仅表示范围登记，不指向已部署的具体产品。 |
|
||
| 6 | 为什么 | 依赖图纳入该类别是为了表示“为上线任务提供制品登记、部署目标、产品运行时及数据库/外部API边界”这一系统能力层；它是用户确认范围内的抽象类别，不代表任一具体产品被采用。 |
|
||
| 7 | 怎么做 | 不适用：本条是抽象依赖类别，不指定唯一可执行产品、安装步骤或操作流程；具体实现需另行识别。 |
|
||
| 8 | 扩展 | 类别层只定义“为上线任务提供制品登记、部署目标、产品运行时及数据库/外部API边界”的边界；供应商、软件、版本、插件和部署属于具体实现或独立依赖对象，不作为本类别的默认扩展。 |
|
||
| 9 | 关联信息 | 本轮v2说明为编辑归纳；历史用户审阅仅对当时说明有效，不自动覆盖此次新增或改写内容。未新增独立审查、运行或效果证据。<br><br>原关联记录（含历史意见）：<br>依赖类别ID=dep-category-deployment-data；类别节点=7.2-7.3 制品注册表、部署目标、产品运行时、数据库与外部API；纳入状态=user_confirmed_in_scope。这是抽象类别，不是具体产品或运行实例。<br>Vibe Coding 重要性暂定：玄阶中级（grade_id=faqi-xuan-intermediate；状态=user_directed_provisional）；范围：Vibe Coding重要性：从代码到产品运行与外部集成；分级依据：支撑部署、数据库和API集成，使代码进入真实产品场景；并非每次编码必需，故属于重要交付扩展而非核心生成。不代表效能评级、运行结果或质量结论。<br>既有关系记录：未记录对象关系。 |
|
||
| 10 | 相关图书 | 本条是依赖图抽象类别，不是书目对象；来源是技术栈的架构节点定义（见第7项），不列产品文档为图书。 |
|
||
| 11 | 它要解决什么问题？ | 该类别覆盖的系统问题是：在工作流中提供“为上线任务提供制品登记、部署目标、产品运行时及数据库/外部API边界”所需的依赖位置。它不单独定义业务输入、结果或特定供应商的服务能力。 |
|
||
| 12 | 为什么这样设计？ | 不适用：该条是类别节点而非具名实现，当前材料不能支持具体设计选择解释。 |
|
||
| 13 | 内部如何实现？ | 不适用：抽象类别没有单一内部实现；不得以任一供应商/实现代表整个类别。 |
|
||
| 14 | 付出了什么代价？ | 该类别会带来与其组成相符的资源、身份、版本、权限和维护责任（部署权限、密钥注入、运行时、数据库/对象存储/队列/API、备份和回滚）；实际费用/性能随具体实现与工作负载变化，依赖图未提供测量。 |
|
||
| 15 | 比较不同技术与方法。 | 仅在目标包含交付/上线时需要；本地开发不是所有场景的部署替代证明。比较须固定任务、数据、权限、版本和预算；类别信息不支持供应商/产品排名。 |
|
||
| 16 | 提炼共同规律。 | 该类别可归纳的架构规则是：先区分为上线任务提供制品登记、部署目标、产品运行时及数据库/外部API边界与具体实现，再按任务选择并验证；类别纳入、依赖存在或调用成功都不证明能力效果。 |
|
||
| 17 | 明确这些规律成立的前提与适用条件。 | 类别依据（原记录）：用户确认此可选依赖类别已核并要求纳入；注册表、部署环境、运行时、数据库与外部API分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。<br>纳入状态：user_confirmed_in_scope；类别不是具体实现或部署。<br>若建立共同规律，须先核实同一问题、版本、环境、权限、协议及工作负载，并记录反例/不适用条件。 |
|
||
| 18 | 结论 | 结论（限第17项条件）：该类别可归纳的架构规则是：先区分为上线任务提供制品登记、部署目标、产品运行时及数据库/外部API边界与具体实现，再按任务选择并验证；类别纳入、依赖存在或调用成功都不证明能力效果。<br>非效果、许可或正式评级证明。 |
|
||
| 19 | 连接规则 | 推理桥梁：证据命题：登记把“7.2-7.3 制品注册表、部署目标、产品运行时、数据库与外部API”明确列作抽象依赖类别；第13项说明“抽象类别没有单一内部实现；不得以任一供应商/实现代表整个类别”，没有单一实现。类别范围见第5项/第20项。推理根据：类别描述的是职责/边界集合，不指定某个实现的接口、协议、权限或效果；同一类别中的具体实现须以各自证据判断。由于本条来源只支持分类与职责区分，没有绑定一个具名部署实例，因此第18项对“先区分为上线任务提供制品登记、部署目标、产品运行时及数据库/外部API边界与具体实现，再按任务选择并验证”的类别层架构归纳，不把它外推为具体产品能力或效果。成立边界：第17项限定为“类别依据（原记录）：用户确认此可选依赖类别已核并要求纳入；注册表、部署环境、运行时、数据库与外部API分别分类；本次品级按Vibe Coding重要性分组，正式效能评级另行判断。 纳入状态：user_confirmed_in_scope；类别不是具体实现或部署。 若建立共同规律，须先核实同一问题、版本、环境、权限、协议及工作负载，并记录反例/不适用条件”；不据此外推未观察效果、许可或正式评级。 |
|
||
| 20 | 依据 | 依据：路径 `.github/docs/gongfa/technology-stack.md`；选区/锚点 `reference-technology-stack-十六技术栈的层级结构`；来源SHA-256 `88ff3494095c2a794acf130d5d2ccc4eb4b67ccdc8c174e7ef09f35c11a450a2`；第5项载完整出处；对应第13项，边界按第17项。快照/静态仅支持记录，不代表独立核验或效果/许可/评级证据。 |
|
||
|
||
<a id="v0-faqi-faqi-auto-skill-create-ffe7ec4d"></a>
|
||
### auto-skill模板生成脚本
|
||
|
||
| 序号 | 说明项 | 内容 |
|
||
|:---:|:---|:---|
|
||
| 1 | 概念 | 生成技能目录和模板文件的历史脚本工件 |
|
||
| 2 | 术语 | auto-skill模板生成脚本 |
|
||
| 3 | 定义 | 工作性定义：一种从固定minimal/full模板建立Skill目录和初始文档的历史生成脚本；指程序内容而非生成后的技能知识，未执行验证。 |
|
||
| 4 | 条目注释 | 编者注（据本条固定来源与既有说明归纳）：--force可覆盖目标；本条程序、输出Skill内容和现存skill指令入口身份不同，退役脚本不因模板补齐重新启用。 |
|
||
| 5 | 来源 | 固定实现/佐证来源记录：{<br> "id": "S08",<br> "purpose": "implementation",<br> "path": ".github/skills/auto-skill/scripts/create-skill.sh",<br> "repository": ".",<br> "revision": "0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2",<br> "sha256": "3eb16d2f24cc2af3e7d7a0f4175e06b0258504795d079ba0920be9dd75f2f7fc",<br> "lines": [<br> 80,<br> 182<br> ],<br> "selection_sha256": "e769660515ada48debbd022fdfb85ec934b4d3413cf3501e06ef075b6d36b1a4"<br>}；{<br> "id": "S07",<br> "purpose": "support",<br> "path": ".github/skills/auto-skill/README.md",<br> "repository": ".",<br> "revision": "0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2",<br> "sha256": "2fd869316c0469d9c4079cd9a19c41698b501bca6ddd2b6cc03617e3f96218f0",<br> "lines": [<br> 1,<br> 21<br> ],<br> "selection_sha256": "2fd869316c0469d9c4079cd9a19c41698b501bca6ddd2b6cc03617e3f96218f0"<br>}<br>本地入口记录：{<br> "path": ".github/skills/auto-skill",<br> "objects": [<br> "faqi-auto-skill-create",<br> "faqi-auto-skill-validate",<br> "faqi-skill-seekers-adapter"<br> ],<br> "sources": [<br> "S07",<br> "S08",<br> "S09",<br> "S10"<br> ],<br> "boundary": "Skill说明/规约与三个独立入口脚本分离，不把整Skill包登记成一件软件。",<br> "pending": [<br> "其他辅助模块未逐模块登记，不能将本次选区称为全包能力审查。"<br> ]<br>}<br>重要性分级记录：{<br> "subject_id": "faqi-auto-skill-create",<br> "grade_id": "faqi-xuan-intermediate",<br> "assignment_status": "user_directed_provisional",<br> "scope": "Vibe Coding重要性：技能资产扩展与复用",<br> "basis": "把操作知识封装为可复用Agent技能，能扩展后续任务能力；属于增益支路，不是最小编码闭环的必需组件。"<br>}<br>运行/部署状态未由此登记证明；版本或路径记录不等于本次运行验证。 |
|
||
| 6 | 为什么 | 在Vibe Coding流程中，本程序的具体用途是生成Skill目录、SKILL.md模板及参考资源骨架。这是从固定README/源码可见功能解释使用场景，不声称它的历史采用动机或实际效果。 |
|
||
| 7 | 怎么做 | 静态README/脚本显示用skill名选择--minimal或--full，可指定--output；目标已存在时默认失败，--force允许继续写入。以上是固定材料描述的历史/静态用法，未执行程序。 |
|
||
| 8 | 扩展 | 提供minimal/full两种模板、输出目录和force选项；full额外创建getting-started、api、examples、troubleshooting参考页。 |
|
||
| 9 | 关联信息 | 本轮v2说明为编辑归纳；历史用户审阅仅对当时说明有效，不自动覆盖此次新增或改写内容。未新增独立审查、运行或效果证据。<br><br>原关联记录（含历史意见）：<br>法器对象ID=faqi-auto-skill-create；本体类型=software-artifact；版本声明=未声明；本地入口=无（模板生成脚本已退役；历史路径与来源见第5项）；相关Skill说明=.github/skills/skill（不同对象，不是该脚本）；当前运行实例/部署状态未在对象记录中声明。<br>Vibe Coding 重要性暂定：玄阶中级（grade_id=faqi-xuan-intermediate；状态=user_directed_provisional）；范围：Vibe Coding重要性：技能资产扩展与复用；分级依据：把操作知识封装为可复用Agent技能，能扩展后续任务能力；属于增益支路，不是最小编码闭环的必需组件。不代表效能评级、运行结果或质量结论。<br>既有关系记录：未记录对象关系。<br>来源ID：S08, S07。 |
|
||
| 10 | 相关图书 | 本条所指是软件实现；固定来源是代码/README/Skill文档（见第7项），没有登记直接相关的图书书目，因此不把技术文档写成图书。 |
|
||
| 11 | 它要解决什么问题？ | 固定材料记录的目标用途是生成Skill目录、SKILL.md模板及参考资源骨架；这说明该程序被设计/登记来处理的工作类型，不等于已验证的需求效果。具体输入、目标路径和副作用须按固定源码/README约定核对，不能把登记重要性当问题验收。 |
|
||
| 12 | 为什么这样设计？ | 源码可观察到的结构是：检查skill名和模板路径，创建assets/scripts/references目录，用sed替换模板变量并写入索引/示例文件；不生成已完成的Skill语义内容。这说明当前控制流如何分工，不推断源码未记载的作者历史设计意图。 |
|
||
| 13 | 内部如何实现？ | 检查skill名和模板路径，创建assets/scripts/references目录，用sed替换模板变量并写入索引/示例文件；不生成已完成的Skill语义内容。仅为固定源码静态说明，不表示已运行或完整审查全部上游实现。 |
|
||
| 14 | 付出了什么代价？ | 会创建目录并写多个文件；force可覆盖SKILL.md和同名参考文件，保留的其他文件与重新生成文件需人工区分。未执行程序，也没有资源/性能实测。 |
|
||
| 15 | 比较不同技术与方法。 | 相对手工建目录，该脚本统一初始骨架；手工方式不需模板依赖但更易漏项。结构一致不证明内容质量。 |
|
||
| 16 | 提炼共同规律。 | 从本程序可归纳的局部规则是：生成Skill目录、SKILL.md模板及参考资源骨架时必须区分程序入口、输入资产和输出/副作用；本条只总结该固定实现边界，不推广为所有工具的效能规律。 |
|
||
| 17 | 明确这些规律成立的前提与适用条件。 | 需bash、相邻assets模板和可写输出目录；skill名限定小写字母/数字/连字符并以字母开头；本说明依据静态源码，未执行；结论限定于第5项绑定的源码修订和说明，不扩展到未观察版本或实际部署。 |
|
||
| 18 | 结论 | 结论（限第17项条件）：从本程序可归纳的局部规则是：生成Skill目录、SKILL.md模板及参考资源骨架时必须区分程序入口、输入资产和输出/副作用；本条只总结该固定实现边界，不推广为所有工具的效能规律。<br>非效果、许可或正式评级证明。 |
|
||
| 19 | 连接规则 | 推理桥梁：证据命题：固定脚本检查名称与模板路径后创建目录、模板、索引及示例文件，但不生成完成的Skill语义内容。推理根据：生成器的可观察输出是骨架文件；骨架不蕴含其内容已满足目标Skill的行为、合同或语义。由于脚本输出只覆盖目录与模板层，没有生成后的技能内容证据，因此第18项关于区分生成入口、输入模板、输出副作用及未完成语义内容的局部规则。成立边界：第17项限定为“需bash、相邻assets模板和可写输出目录；skill名限定小写字母/数字/连字符并以字母开头；本说明依据静态源码，未执行；结论限定于第5项绑定的源码修订和说明，不扩展到未观察版本或实际部署”；不据此外推未观察效果、许可或正式评级。 |
|
||
| 20 | 依据 | 依据：来源ID `S08`；路径 `.github/skills/auto-skill/scripts/create-skill.sh`；选区SHA-256 `e769660515ada48debbd022fdfb85ec934b4d3413cf3501e06ef075b6d36b1a4`；修订 `0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2`；第5项载完整出处；对应第13项，边界按第17项。快照/静态仅支持记录，不代表独立核验或效果/许可/评级证据。 |
|
||
|
||
<a id="v0-faqi-faqi-auto-skill-validate-5244b18f"></a>
|
||
### auto-skill结构校验脚本
|
||
|
||
| 序号 | 说明项 | 内容 |
|
||
|:---:|:---|:---|
|
||
| 1 | 概念 | 检查技能元数据与文档结构的历史校验程序 |
|
||
| 2 | 术语 | auto-skill结构校验脚本 |
|
||
| 3 | 定义 | 工作性定义：一种对Skill的frontmatter、必要章节和结构执行普通或strict规则检查的历史校验脚本，不提供技能效果判断。 |
|
||
| 4 | 条目注释 | 编者注（据本条固定来源与既有说明归纳）：strict把部分推荐项变成失败条件；结构成功不证明语义、执行正确性或任务效果，退役入口不恢复。 |
|
||
| 5 | 来源 | 固定实现/佐证来源记录：{<br> "id": "S09",<br> "purpose": "implementation",<br> "path": ".github/skills/auto-skill/scripts/validate-skill.sh",<br> "repository": ".",<br> "revision": "0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2",<br> "sha256": "deb5cf2529a93c87c8b7323b55ffc6d7798e6b59652351ba795340ac8c0061c9",<br> "lines": [<br> 67,<br> 160<br> ],<br> "selection_sha256": "dbd460af6a32307709a11281c7b90925b9fd9820128eb04881c80c020a99f0dc"<br>}；{<br> "id": "S07",<br> "purpose": "support",<br> "path": ".github/skills/auto-skill/README.md",<br> "repository": ".",<br> "revision": "0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2",<br> "sha256": "2fd869316c0469d9c4079cd9a19c41698b501bca6ddd2b6cc03617e3f96218f0",<br> "lines": [<br> 1,<br> 21<br> ],<br> "selection_sha256": "2fd869316c0469d9c4079cd9a19c41698b501bca6ddd2b6cc03617e3f96218f0"<br>}<br>本地入口记录：{<br> "path": ".github/skills/auto-skill",<br> "objects": [<br> "faqi-auto-skill-create",<br> "faqi-auto-skill-validate",<br> "faqi-skill-seekers-adapter"<br> ],<br> "sources": [<br> "S07",<br> "S08",<br> "S09",<br> "S10"<br> ],<br> "boundary": "Skill说明/规约与三个独立入口脚本分离，不把整Skill包登记成一件软件。",<br> "pending": [<br> "其他辅助模块未逐模块登记，不能将本次选区称为全包能力审查。"<br> ]<br>}<br>重要性分级记录：{<br> "subject_id": "faqi-auto-skill-validate",<br> "grade_id": "faqi-xuan-intermediate",<br> "assignment_status": "user_directed_provisional",<br> "scope": "Vibe Coding重要性：技能资产质量与可载入性",<br> "basis": "降低扩展技能结构错误造成的接入阻断；不判断语义正确性，属于能力扩展的质量辅助。"<br>}<br>运行/部署状态未由此登记证明；版本或路径记录不等于本次运行验证。 |
|
||
| 6 | 为什么 | 在Vibe Coding流程中，本程序的具体用途是检查Skill的frontmatter与约定章节结构。这是从固定README/源码可见功能解释使用场景，不声称它的历史采用动机或实际效果。 |
|
||
| 7 | 怎么做 | 静态README建议用目标目录调用脚本，并在需要严格模式时添加--strict；脚本读取SKILL.md并检查字段、目录名和章节。以上是固定材料描述的历史/静态用法，未执行程序。 |
|
||
| 8 | 扩展 | 提供普通/strict检查；strict把部分推荐章节和样例数量升级为失败条件。 |
|
||
| 9 | 关联信息 | 本轮v2说明为编辑归纳；历史用户审阅仅对当时说明有效，不自动覆盖此次新增或改写内容。未新增独立审查、运行或效果证据。<br><br>原关联记录（含历史意见）：<br>法器对象ID=faqi-auto-skill-validate；本体类型=software-artifact；版本声明=未声明；本地入口=无（结构校验脚本已退役；历史路径与来源见第5项）；相关Skill说明=.github/skills/skill（不同对象，不是该脚本）；当前运行实例/部署状态未在对象记录中声明。<br>Vibe Coding 重要性暂定：玄阶中级（grade_id=faqi-xuan-intermediate；状态=user_directed_provisional）；范围：Vibe Coding重要性：技能资产质量与可载入性；分级依据：降低扩展技能结构错误造成的接入阻断；不判断语义正确性，属于能力扩展的质量辅助。不代表效能评级、运行结果或质量结论。<br>既有关系记录：未记录对象关系。<br>来源ID：S09, S07。 |
|
||
| 10 | 相关图书 | 本条所指是软件实现；固定来源是代码/README/Skill文档（见第7项），没有登记直接相关的图书书目，因此不把技术文档写成图书。 |
|
||
| 11 | 它要解决什么问题？ | 固定材料记录的目标用途是检查Skill的frontmatter与约定章节结构；这说明该程序被设计/登记来处理的工作类型，不等于已验证的需求效果。具体输入、目标路径和副作用须按固定源码/README约定核对，不能把登记重要性当问题验收。 |
|
||
| 12 | 为什么这样设计？ | 源码可观察到的结构是：用awk提取YAML frontmatter，检查name/description及strict规则；过滤代码围栏后检查要求章节、references/index、Quick Reference行数和Examples数量。这说明当前控制流如何分工，不推断源码未记载的作者历史设计意图。 |
|
||
| 13 | 内部如何实现？ | 用awk提取YAML frontmatter，检查name/description及strict规则；过滤代码围栏后检查要求章节、references/index、Quick Reference行数和Examples数量。仅为固定源码静态说明，不表示已运行或完整审查全部上游实现。 |
|
||
| 14 | 付出了什么代价？ | 读取Skill文档并创建/清理临时过滤文件；检查只覆盖脚本定义的格式规则，不验证Skill语义、调用效果或安全性。未执行程序，也没有资源/性能实测。 |
|
||
| 15 | 比较不同技术与方法。 | 比人工快速浏览更一致地检查固定结构；与语义审查互补，不能代替真实使用和行为验证；无准确率比较数据。 |
|
||
| 16 | 提炼共同规律。 | 从本程序可归纳的局部规则是：检查Skill的frontmatter与约定章节结构时必须区分程序入口、输入资产和输出/副作用；本条只总结该固定实现边界，不推广为所有工具的效能规律。 |
|
||
| 17 | 明确这些规律成立的前提与适用条件。 | 需bash、awk、grep及目标Skill目录；frontmatter须从首行开始；strict的章节/示例门槛按固定脚本执行，未运行验证当前环境；结论限定于第5项绑定的源码修订和说明，不扩展到未观察版本或实际部署。 |
|
||
| 18 | 结论 | 结论（限第17项条件）：从本程序可归纳的局部规则是：检查Skill的frontmatter与约定章节结构时必须区分程序入口、输入资产和输出/副作用；本条只总结该固定实现边界，不推广为所有工具的效能规律。<br>非效果、许可或正式评级证明。 |
|
||
| 19 | 连接规则 | 推理桥梁：证据命题：固定脚本检查frontmatter、章节、索引和示例等结构条件，不读取行为结果作为正确性证据。推理根据：结构条件只能证明被检查的形式约束；行为与语义正确需要独立内容审查或执行证据，不能由格式检查推出。由于校验器覆盖面限于结构，未覆盖Skill的目标行为，因此第18项关于把结构通过与语义/效果判断分开的结论。成立边界：第17项限定为“需bash、awk、grep及目标Skill目录；frontmatter须从首行开始；strict的章节/示例门槛按固定脚本执行，未运行验证当前环境；结论限定于第5项绑定的源码修订和说明，不扩展到未观察版本或实际部署”；不据此外推未观察效果、许可或正式评级。 |
|
||
| 20 | 依据 | 依据：来源ID `S09`；路径 `.github/skills/auto-skill/scripts/validate-skill.sh`；选区SHA-256 `dbd460af6a32307709a11281c7b90925b9fd9820128eb04881c80c020a99f0dc`；修订 `0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2`；第5项载完整出处；对应第13项，边界按第17项。快照/静态仅支持记录，不代表独立核验或效果/许可/评级证据。 |
|
||
|
||
<a id="v0-faqi-faqi-skill-seekers-cc1f7ed8"></a>
|
||
### Skill Seekers程序
|
||
|
||
| 序号 | 说明项 | 内容 |
|
||
|:---:|:---|:---|
|
||
| 1 | 概念 | 具有命令行及可选MCP接口的固定技能生成程序工件 |
|
||
| 2 | 术语 | Skill Seekers程序 |
|
||
| 3 | 定义 | 工作性定义：一种按固定修订纳入、提供多个CLI入口和可选MCP模块的Skill Seekers软件工件；源码已经从当前树退役，冻结选区不证明当前可安装或运行。 |
|
||
| 4 | 条目注释 | 编者注（据本条固定来源与既有说明归纳）：3.5.1仅为pyproject声明；MCP注释34项、静态40个装饰函数及health文本2.1.1均不代表运行清单或发布版本，未执行上游。 |
|
||
| 5 | 来源 | 固定实现/佐证来源记录：{<br> "id": "S16",<br> "purpose": "implementation",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/cli/main.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "8c02660dacd304f51fe8c4a9685d3f6d5324a7eef7779b6baa7325827bf01985",<br> "lines": [<br> 39,<br> 116<br> ],<br> "selection_sha256": "60fba27fbe444499a1e95b5dc69edc8b0d34d6c26a30039dcbf9d9205ffdfb14"<br>}；{<br> "id": "S14",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/pyproject.toml",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "40820d20d8f56c1dc24c8f432141fa438d54473acbfecfa716fc9d188cbc8294",<br> "lines": [<br> 1,<br> 15<br> ],<br> "selection_sha256": "8fc8e7df82f18edc826b13f63f097661c1f40b19d2e7ab576e25854b453919e3"<br>}；{<br> "id": "S15",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/pyproject.toml",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "40820d20d8f56c1dc24c8f432141fa438d54473acbfecfa716fc9d188cbc8294",<br> "lines": [<br> 301,<br> 327<br> ],<br> "selection_sha256": "ac6771e334ffad6fe8cb4934797de797375c87d4c33a16afff72de8d1642893f"<br>}；{<br> "id": "S42",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/LICENSE",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "d131d0e96700cd78f8b3fa7ed79a47b019a0653066500faff376233246b6504d",<br> "lines": [<br> 1,<br> 22<br> ],<br> "selection_sha256": "d131d0e96700cd78f8b3fa7ed79a47b019a0653066500faff376233246b6504d"<br>}；{<br> "id": "S44",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/pyproject.toml",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "40820d20d8f56c1dc24c8f432141fa438d54473acbfecfa716fc9d188cbc8294",<br> "lines": [<br> 45,<br> 69<br> ],<br> "selection_sha256": "e892c55c18d3d786696bf226eef30e4651216b0b71b89f35aa957f486ce0210f"<br>}；{<br> "id": "S45",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/cli/main.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "8c02660dacd304f51fe8c4a9685d3f6d5324a7eef7779b6baa7325827bf01985",<br> "lines": [<br> 41,<br> 66<br> ],<br> "selection_sha256": "67527b228def54d21c5adc56b822ae446b51e24d18b4ca82b4a66669ca184d17"<br>}；{<br> "id": "S46",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/cli/agent_client.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "2fff7e6de630b6c8871db3419661195125c6128ac71d4d76f04e7561f7bdac17",<br> "lines": [<br> 35,<br> 91<br> ],<br> "selection_sha256": "8273620e89e199a39cd5b2afd65dcfe4483d6b463ab3435f2dceb59270ec5a59"<br>}；{<br> "id": "S47",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/cli/agent_client.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "2fff7e6de630b6c8871db3419661195125c6128ac71d4d76f04e7561f7bdac17",<br> "lines": [<br> 175,<br> 200<br> ],<br> "selection_sha256": "e1dffcec8fd29c41210478f2516c1a970fa0082d0c5666b8f2f47657e7226608"<br>}；{<br> "id": "S48",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/cli/agent_client.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "2fff7e6de630b6c8871db3419661195125c6128ac71d4d76f04e7561f7bdac17",<br> "lines": [<br> 286,<br> 415<br> ],<br> "selection_sha256": "24bbde0e597053cc6a0430fb83f870b0007bc5d1fac7916645caa6687d65c153"<br>}；{<br> "id": "S49",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/cli/install_skill.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "146be443d3b73b1e5c706b105fd0780831275baa6d0d61424b3c10d03dfa79aa",<br> "lines": [<br> 83,<br> 156<br> ],<br> "selection_sha256": "5d2fde106240cae8b78d502c274a07a764ff5a2f4e745f3f5a977af08dae7cf5"<br>}；{<br> "id": "S50",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/cli/upload_skill.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "2967da60c32c2495ea993f9122c6472d76ab86d3bcae878831fbeb07c55b0d1e",<br> "lines": [<br> 33,<br> 89<br> ],<br> "selection_sha256": "1893b3f3bfc12dc0ef7ff0b2f2e94d1c72e216bd9d229037f8a8d70b7a18b2f5"<br>}；{<br> "id": "S66",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/mcp/server.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "cc6c4f24e5b91ab158f2bfbc4ebb27a38ce84d2937473dd85a6c2d035fc3b851",<br> "lines": [<br> 217,<br> 232<br> ],<br> "selection_sha256": "3656ba540327c3b7a1d33dffb02caba7b39ad65539fedb8c1d4d653d6304c994"<br>}；{<br> "id": "S67",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/mcp/server_fastmcp.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "19ba3010ea3bc5101953e44070932ec239d67908e1a0e992437665f98b827200",<br> "lines": [<br> 1,<br> 195<br> ],<br> "selection_sha256": "4aac45465ef6f0be7dd815096a3b9a9fdd1d7dbb53022f407691cf5786305d89"<br>}；{<br> "id": "S68",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/mcp/server_fastmcp.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "19ba3010ea3bc5101953e44070932ec239d67908e1a0e992437665f98b827200",<br> "lines": [<br> 1648,<br> 1835<br> ],<br> "selection_sha256": "06302c5f4aeec783710f5fc8c98d27be93d48c13d10fab5b677a743590787a94"<br>}；{<br> "id": "S69",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/mcp/server_fastmcp.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "19ba3010ea3bc5101953e44070932ec239d67908e1a0e992437665f98b827200",<br> "lines": [<br> 887,<br> 1050<br> ],<br> "selection_sha256": "21c671d1565867a5787f19da94e5cebefbb52993f3833f323afcc324ed59fb5e"<br>}；{<br> "id": "S70",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/mcp/tools/packaging_tools.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "7654385b60889705d98a3cc8e92602d13cadaf920ead26561e7fbb3a349a1fab",<br> "lines": [<br> 32,<br> 173<br> ],<br> "selection_sha256": "a042393939aa45cc7c4b046630c5a32b418895e25421f49b070c66fc6d116f9f"<br>}；{<br> "id": "S71",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/mcp/tools/packaging_tools.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "7654385b60889705d98a3cc8e92602d13cadaf920ead26561e7fbb3a349a1fab",<br> "lines": [<br> 232,<br> 298<br> ],<br> "selection_sha256": "c1abd4a79a92647fd3a4044f1cddc566c6dd953c3aa5d6c6824db8d9e27ba109"<br>}；{<br> "id": "S72",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/mcp/tools/scraping_tools.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "0073daae89b191d907fb080daf78f044d55d6890a8c929e7dcdc10c9ff19a735",<br> "lines": [<br> 211,<br> 310<br> ],<br> "selection_sha256": "361fb788f3029d6990b596a7675a68eb4f81df8d1e70404a6489780f93276f9d"<br>}；{<br> "id": "S73",<br> "purpose": "support",<br> "path": ".github/tools/external/Skill_Seekers-development/src/skill_seekers/mcp/tools/packaging_tools.py",<br> "repository": ".github/tools/external/Skill_Seekers-development",<br> "revision": "26638b248279a3b001b651475e0f28975f5ff069",<br> "sha256": "7654385b60889705d98a3cc8e92602d13cadaf920ead26561e7fbb3a349a1fab",<br> "lines": [<br> 433,<br> 904<br> ],<br> "selection_sha256": "5eef32044bf73950d2c4168ff30faa18e8064400aa0ee4f78dff9029d4fae074"<br>}<br>本地入口记录：{<br> "path": ".github/tools/external/Skill_Seekers-development",<br> "objects": [<br> "faqi-skill-seekers"<br> ],<br> "sources": [<br> "S14",<br> "S15",<br> "S16",<br> "S42",<br> "S44",<br> "S45",<br> "S46",<br> "S47",<br> "S48",<br> "S49",<br> "S50",<br> "S66",<br> "S67",<br> "S68",<br> "S69",<br> "S70",<br> "S71",<br> "S72",<br> "S73"<br> ],<br> "boundary": "源码内容与仓库载体、接口规范、抓取过程、输入资料和生成Skill分开。",<br> "pending": [<br> "2026-10-14：S45–S50绑定固定CLI路由、AgentClient与install/upload静态选区。CLI映射包含create/enhance/package/upload/install/install-agent等；AgentClient的auto模式按环境密钥选择API或本地代理，API路径将prompt发送给provider，本地subprocess.run未显式限制env；Claude预设含--dangerously-skip-permissions，Codex含--full-auto和--skip-git-repo-check。install将auto_upload设为默认true（可用--no-upload），upload路径调用目标adaptor并可从环境变量取key。仅静态审阅，未运行、联网、上传或读取凭据；完整MCP链路、数据范围/来源授权、子进程权限、环境隔离、外部与本地写入及恢复路径仍待审。",<br> "仓库LICENSE标注MIT，但版权行保留[Your Name/Username]占位符；权利主体与授权未核，不作许可证批准依据。",<br> "固定pyproject将PyMuPDF>=1.24.14列为核心依赖；2026-10-14本地Python 3.12.3环境未安装PyMuPDF（pip另有~umpy无效发行警告），运行/doctor/PDF路径未验证。这是环境观察，不等于上游实现缺陷。",<br> "2026-10-15：在Python 3.12.3环境运行python3 -m pip show PyMuPDF仍显示未安装；未安装依赖、未运行Skill Seekers。运行验证仍为false；此项只是目标环境依赖存在性检查，不是程序测试。",<br> "2026-10-16：S66–S73只静态复核固定pin的MCP兼容入口、FastMCP、抓取及package/upload/install选区。默认stdio，HTTP默认127.0.0.1:8000，选区配置通配CORS；回环监听与CORS不等于认证授权。package默认auto_upload=true，命中平台密钥时加入上传标志；upload显式api_key被放入--api-key进程参数，Popen未显式限定env，凭据暴露与环境继承边界尚未确认，未读取任何真实值。install除抓取、AI增强和打包外，还含条件上传及marketplace发布分支，auto_upload=false不关闭前序步骤或独立发布支路；scrape_docs的unlimited临时配置写入先于dry_run分支，不能把预览声明推广为零I/O或可完整回滚。源码注释34工具、静态40装饰函数和health的2.1.1字符串都不是运行清单或已核版本。未导入、执行、启服务、抓取、上传或安装；认证、数据来源授权、完整下游副作用、超时/取消及恢复仍待独立验证。"<br> ]<br>}<br>重要性分级记录：{<br> "subject_id": "faqi-skill-seekers",<br> "grade_id": "faqi-xuan-intermediate",<br> "assignment_status": "user_directed_provisional",<br> "scope": "Vibe Coding重要性：外部知识转可复用技能",<br> "basis": "增加Agent可复用的领域能力和上下文资产；需特定工作流，不能替代通用推理与工具执行。"<br>}<br>运行/部署状态未由此登记证明；版本或路径记录不等于本次运行验证。 |
|
||
| 6 | 为什么 | 在Vibe Coding流程中，本程序的具体用途是把文档、GitHub仓库、PDF等输入加工为可复用Skill，并提供CLI及可选MCP入口。这是从固定README/源码可见功能解释使用场景，不声称它的历史采用动机或实际效果。 |
|
||
| 7 | 怎么做 | 固定CLI入口注册create、enhance、package、upload、install等命令；MCP源码另提供stdio/HTTP工具注册。具体调用需按对应命令与配置核对；没有运行。以上是固定材料描述的历史/静态用法，未执行程序。 |
|
||
| 8 | 扩展 | 固定源码列出18个CLI命令并含可选MCP模块；源码注释工具数、静态装饰函数数和health版本文本不等同于运行工具清单或产品发布版本。 |
|
||
| 9 | 关联信息 | 本轮v2说明为编辑归纳；历史用户审阅仅对当时说明有效，不自动覆盖此次新增或改写内容。未新增独立审查、运行或效果证据。<br><br>原关联记录（含历史意见）：<br>法器对象ID=faqi-skill-seekers；本体类型=software-artifact；版本声明=3.5.1（仅源码声明）；本地入口=无（固定Gitlink已从当前树移除；冻结来源、SHA、初审及重要性记录保留）；当前运行实例/部署状态未在对象记录中声明。；当前资源关联ID=repo-rules-scaffolds-skills-cd973130（关联不等于许可或运行证明）。固定修订许可观察：LICENSE文本标为MIT，但版权行仍为[Your Name/Username]占位符；同修订pyproject.toml的authors字段列为Yusuf Karaaslan。作者元数据不证明版权归属或授权；本项目仍未批准该许可证。<br>Vibe Coding 重要性暂定：玄阶中级（grade_id=faqi-xuan-intermediate；状态=user_directed_provisional）；范围：Vibe Coding重要性：外部知识转可复用技能；分级依据：增加Agent可复用的领域能力和上下文资产；需特定工作流，不能替代通用推理与工具执行。不代表效能评级、运行结果或质量结论。<br>既有关系记录：未记录对象关系。<br>关联资源ID：repo-rules-scaffolds-skills-cd973130。资源链接/本地关联不证明许可、兼容性或功能等价。<br>来源ID：S16, S14, S15, S42, S44, S45, S46, S47, S48, S49, S50, S66, S67, S68, S69, S70, S71, S72, S73。 |
|
||
| 10 | 相关图书 | 本条所指是软件实现；固定来源是代码/README/Skill文档（见第7项），没有登记直接相关的图书书目，因此不把技术文档写成图书。 |
|
||
| 11 | 它要解决什么问题？ | 固定材料记录的目标用途是把文档、GitHub仓库、PDF等输入加工为可复用Skill，并提供CLI及可选MCP入口；这说明该程序被设计/登记来处理的工作类型，不等于已验证的需求效果。具体输入、目标路径和副作用须按固定源码/README约定核对，不能把登记重要性当问题验收。 |
|
||
| 12 | 为什么这样设计？ | 源码可观察到的结构是：静态实现由CLI路由到抓取、增强、打包、安装/上传模块；MCP入口把模块函数注册为工具，部分实现再调用子进程或外部API。这说明当前控制流如何分工，不推断源码未记载的作者历史设计意图。 |
|
||
| 13 | 内部如何实现？ | 静态实现由CLI路由到抓取、增强、打包、安装/上传模块；MCP入口把模块函数注册为工具，部分实现再调用子进程或外部API。所检FastMCP HTTP路径以host参数启动uvicorn，默认绑定127.0.0.1且可通过--host指定其他地址；所检server路径未配置应用层认证，并设置allow_origins=["*"]与allow_credentials=True。以上仅为固定修订源码的静态说明，不表示已运行或完整审查全部上游实现。 |
|
||
| 14 | 付出了什么代价？ | 条件性安全风险：所检HTTP MCP入口未配置应用层认证；若服务绑定非回环地址或经端口转发并可被不可信调用者访问，部分工具可触发本地文件I/O、子进程及外部上传/发布。upload_skill的api_key参数最终加入子进程argv（--api-key），形成进程参数暴露面；操作系统中的实际可见范围未实测。package/install按默认设置可在检测到平台密钥时自动上传；抓取及增强还会产生网络、本地文件I/O和API配额消耗。未读取真实凭据、未执行程序或做资源/性能实测。 |
|
||
| 15 | 比较不同技术与方法。 | 相对手工整理文档，程序把抓取、增强、打包流程自动化；相对只用CLI，MCP提供另一调用边界但增加服务依赖。仓内静态内容不支持质量/性能排名。 |
|
||
| 16 | 提炼共同规律。 | 从本程序可归纳的局部规则是：把文档、GitHub仓库、PDF等输入加工为可复用Skill，并提供CLI及可选MCP入口时必须区分程序入口、输入资产和输出/副作用；本条只总结该固定实现边界，不推广为所有工具的效能规律。 |
|
||
| 17 | 明确这些规律成立的前提与适用条件。 | 适用边界：仅固定修订26638b248279a3b001b651475e0f28975f5ff069的S67–S73选区静态审阅；HTTP暴露风险以服务可被不可信网络访问为前提，反向代理等外部防护未核；argv风险仅确认密钥进入子进程参数数组，操作系统进程可见范围未测。未运行服务、导入或执行上游代码、安装依赖、联网、抓取、上传、验证浏览器请求或读取真实凭据；未覆盖全包、依赖漏洞、来源授权、完整路径沙箱及取消/恢复。dry-run/关闭自动上传不代表所有上游步骤零I/O或完整回滚；不据此声称漏洞利用、运行安全或全包审查。 |
|
||
| 18 | 结论 | 静态审阅结果：WARN（范围与限制见第17项）。从本程序可归纳的局部规则是：把文档、GitHub仓库、PDF等输入加工为可复用Skill，并提供CLI及可选MCP入口时必须区分程序入口、输入资产和输出/副作用；本条只总结该固定实现边界，不推广为所有工具的效能规律。针对固定修订，不要向不可信网络暴露HTTP MCP；在未配置身份认证/授权和调用边界前仅限回环监听；不要通过MCP api_key参数向子进程argv传递秘密，应改用受控的非argv注入并核对目标系统的进程可见边界。以上是静态风险使用建议，不是漏洞利用或运行行为证明。<br>非效果、许可或正式评级证明。 |
|
||
| 19 | 连接规则 | 推理桥梁：证据命题：固定源码表明CLI/MCP路由到抓取、文件I/O、子进程、API及上传等不同处理环节；来源S67/S68显示FastMCP入口及可配置HTTP监听，所检路径默认回环、允许任意Origin且未配置应用层认证；S69提供MCP工具参数，S70以Popen启动子进程，S71把api_key放入--api-key参数，S73显示install含抓取、AI增强、打包及条件上传/发布路径。推理根据：观察到的调用边界支持区分程序入口、输入资产和副作用的局部规则；若HTTP端点可被不可信调用者访问且无其他外部访问控制，工具权限会转化为本地文件/子进程和外部副作用风险；把密钥置于argv则形成进程参数暴露面。由于这些是固定源码可观察的调用关系而非运行或利用结果，因此第18项仅给出局部规则、条件性风险与使用建议。成立边界：以第17项列出的适用条件、限制及其待核状态为准；本节仅覆盖固定修订S67–S73静态选区，实际网络可达性、外部防护和进程可见范围未知；不据此外推未观察效果、许可或正式评级。附加限定：不证明漏洞利用或运行安全。 |
|
||
| 20 | 依据 | 依据：来源ID S67, S68, S69, S70, S71, S72, S73；固定submodule修订26638b248279a3b001b651475e0f28975f5ff069；第5项载完整历史路径、源码SHA及选区SHA。S67/S68为FastMCP与HTTP监听，S69为MCP接口，S70/S71为子进程与API key参数流，S72为抓取，S73为install编排；对应第13项内部实现说明，边界按第17项。只读静态审阅，未运行scanner或上游代码；不证明利用、运行安全、依赖安全、许可或正式评级。 |
|
||
|
||
<a id="v0-faqi-faqi-claude-skill-init-3a642a5d"></a>
|
||
### 官方Skill初始化脚本
|
||
|
||
| 序号 | 说明项 | 内容 |
|
||
|:---:|:---|:---|
|
||
| 1 | 概念 | 生成单个技能目录与资源骨架的Python程序工件 |
|
||
| 2 | 术语 | 官方Skill初始化脚本 |
|
||
| 3 | 定义 | 工作性定义：一种按name/path参数创建单个Skill目录、模板和资源骨架，并在目标已存在时拒绝创建的固定Python初始化程序，未执行验证。 |
|
||
| 4 | 条目注释 | 编者注（据本条固定来源与既有说明归纳）：仅收skill-creator中的独立初始化脚本，官方技能集合、模板和其他辅助脚本不并入同一身份；当前入口已退役。 |
|
||
| 5 | 来源 | 固定实现/佐证来源记录：{<br> "id": "S23",<br> "purpose": "implementation",<br> "path": ".github/tools/external/claude-official-skills/skills/skill-creator/scripts/init_skill.py",<br> "repository": ".github/tools/external/claude-official-skills",<br> "revision": "1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563",<br> "sha256": "cf12790f1d4958799281920d599f56aea38fb5c26e2812a61dd740bf3d4b6b99",<br> "lines": [<br> 194,<br> 304<br> ],<br> "selection_sha256": "f3ef6ff82946a9596d5cacfc1ed0405765187e5ffec5a4ede6c15f5e8dd248dd"<br>}；{<br> "id": "S22",<br> "purpose": "support",<br> "path": ".github/tools/external/claude-official-skills/README.md",<br> "repository": ".github/tools/external/claude-official-skills",<br> "revision": "1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563",<br> "sha256": "d7c5c2f9b248c7c0b31f093cf22b9a7407f5b093c8ca9ebe75a5b6845b02b76e",<br> "lines": [<br> 1,<br> 28<br> ],<br> "selection_sha256": "672c572d34a077a534754b7311d19db68a8402c86fe64e35be5e80da3ae7453a"<br>}；{<br> "id": "S43",<br> "purpose": "support",<br> "path": ".github/tools/external/claude-official-skills/skills/skill-creator/LICENSE.txt",<br> "repository": ".github/tools/external/claude-official-skills",<br> "revision": "1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563",<br> "sha256": "58d1e17ffe5109a7ae296caafcadfdbe6a7d176f0bc4ab01e12a689b0499d8bd",<br> "lines": [<br> 1,<br> 203<br> ],<br> "selection_sha256": "58d1e17ffe5109a7ae296caafcadfdbe6a7d176f0bc4ab01e12a689b0499d8bd"<br>}；{<br> "id": "S51",<br> "purpose": "support",<br> "path": ".github/tools/external/claude-official-skills/skills/skill-creator/SKILL.md",<br> "repository": ".github/tools/external/claude-official-skills",<br> "revision": "1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563",<br> "sha256": "d57b6e3a44535b9c0ef454dad5c86f5df78185fc80a65c7092885b4b5e10f81b",<br> "lines": [<br> 263,<br> 275<br> ],<br> "selection_sha256": "a8130ff1f013777e2c076569f5567924a4a0f3b23df7134ab4b0b99dd1aa86e9"<br>}<br>本地入口记录：{<br> "path": ".github/tools/external/claude-official-skills",<br> "objects": [<br> "faqi-claude-skill-init"<br> ],<br> "sources": [<br> "S22",<br> "S23",<br> "S43",<br> "S51"<br> ],<br> "boundary": "集合入口不等于法器身份；指令内容与脚本实现分别判断。",<br> "pending": [<br> "README明确部分文档Skill仅source-available，不能把整个集合称为同一开源许可证；skill-creator/LICENSE.txt提供Apache 2.0文本，但其附录版权字段为通用占位符，不能单独证明权利主体或完成全量许可审查。",<br> "本次不批准再分发/商用许可。",<br> "S51绑定skill-creator/SKILL.md步骤3和调用形式，证实该文档要求执行S23；它不验证S23实际输入校验或路径限制，且本次未执行脚本。",<br> "2026-10-14：固定pin 1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563的S23（init_skill.py:194-303）静态复核：CLI提示skill_name应为小写kebab-case，但main未校验；函数直接拼接Path(path).resolve()/skill_name且未检查目标仍在指定父目录内，若调用方传入含../或绝对路径的名称，输出可越出预期目录。目录/模板创建中途失败只返回错误，不回滚部分输出。风险取决于调用方输入控制；未运行脚本、未创建测试文件，不作可利用性或运行安全结论。其余辅助脚本仍未逐模块展开。"<br> ]<br>}<br>重要性分级记录：{<br> "subject_id": "faqi-claude-skill-init",<br> "grade_id": "faqi-xuan-initial",<br> "assignment_status": "user_directed_provisional",<br> "scope": "Vibe Coding重要性：特定Skill模板初始化",<br> "basis": "降低Claude Skill结构初始化成本，作用范围绑定特定生态，可手工完成且不影响其他Agent的基础闭环。"<br>}<br>运行/部署状态未由此登记证明；版本或路径记录不等于本次运行验证。 |
|
||
| 6 | 为什么 | 在Vibe Coding流程中，本程序的具体用途是固定skill-creator目录中的Python初始化程序，生成新Skill目录及模板/示例文件。这是从固定README/源码可见功能解释使用场景，不声称它的历史采用动机或实际效果。 |
|
||
| 7 | 怎么做 | 固定Skill文档给出init_skill.py <skill-name> --path <output-directory>；脚本验证参数后创建目标目录、SKILL.md及scripts/references/assets示例文件；未执行。以上是固定材料描述的历史/静态用法，未执行程序。 |
|
||
| 8 | 扩展 | 固定实现提供name/path参数及Skill模板资源骨架；生成内容仍需人工编辑，不把整个skill-creator Skill或其其他脚本并入本程序对象。 |
|
||
| 9 | 关联信息 | 本轮v2说明为编辑归纳；历史用户审阅仅对当时说明有效，不自动覆盖此次新增或改写内容。未新增独立审查、运行或效果证据。<br><br>原关联记录（含历史意见）：<br>法器对象ID=faqi-claude-skill-init；本体类型=software-artifact；版本声明=未声明；本地入口=无；Claude Skills固定Gitlink与独立初始化器已从当前树移除（2026-10-22）；冻结来源字节、修订、SHA和历史初审仍保留于档案。当前运行实例/部署状态未在对象记录中声明。<br>Vibe Coding 重要性暂定：玄阶初级（grade_id=faqi-xuan-initial；状态=user_directed_provisional）；范围：Vibe Coding重要性：特定Skill模板初始化；分级依据：降低Claude Skill结构初始化成本，作用范围绑定特定生态，可手工完成且不影响其他Agent的基础闭环。不代表效能评级、运行结果或质量结论。<br>既有关系记录：未记录对象关系。<br>来源ID：S23, S22, S43, S51。 |
|
||
| 10 | 相关图书 | 本条所指是软件实现；固定来源是代码/README/Skill文档（见第7项），没有登记直接相关的图书书目，因此不把技术文档写成图书。 |
|
||
| 11 | 它要解决什么问题？ | 固定材料记录的目标用途是固定skill-creator目录中的Python初始化程序，生成新Skill目录及模板/示例文件；这说明该程序被设计/登记来处理的工作类型，不等于已验证的需求效果。具体输入、目标路径和副作用须按固定源码/README约定核对，不能把登记重要性当问题验收。 |
|
||
| 12 | 为什么这样设计？ | 源码可观察到的结构是：由name/path构造目标路径，已存在则返回错误；创建目录树，格式化SKILL_TEMPLATE与示例文件，设置example.py为可执行权限，并输出后续编辑指引。这说明当前控制流如何分工，不推断源码未记载的作者历史设计意图。 |
|
||
| 13 | 内部如何实现？ | 由name/path构造目标路径，已存在则返回错误；创建目录树，格式化SKILL_TEMPLATE与示例文件，设置example.py为可执行权限，并输出后续编辑指引。仅为固定源码静态说明，不表示已运行或完整审查全部上游实现。 |
|
||
| 14 | 付出了什么代价？ | 会在指定路径创建目录和多个文件，可能部分写入后失败；需要用户检查模板并维护生成内容，当前没有执行或测量。未执行程序，也没有资源/性能实测。 |
|
||
| 15 | 比较不同技术与方法。 | 相对手工创建文件，该脚本统一目录和示例骨架；手工方式更灵活但容易漏文件。初始化成功不证明生成的Skill符合质量要求。 |
|
||
| 16 | 提炼共同规律。 | 从本程序可归纳的局部规则是：固定skill-creator目录中的Python初始化程序，生成新Skill目录及模板/示例文件时必须区分程序入口、输入资产和输出/副作用；本条只总结该固定实现边界，不推广为所有工具的效能规律。 |
|
||
| 17 | 明确这些规律成立的前提与适用条件。 | 需Python运行时、可写目标路径和符合约定的skill名；目标目录若已存在会拒绝创建；后续内容须按Skill规范完善并校验；结论限定于第5项绑定的源码修订和说明，不扩展到未观察版本或实际部署。 |
|
||
| 18 | 结论 | 结论（限第17项条件）：从本程序可归纳的局部规则是：固定skill-creator目录中的Python初始化程序，生成新Skill目录及模板/示例文件时必须区分程序入口、输入资产和输出/副作用；本条只总结该固定实现边界，不推广为所有工具的效能规律。<br>非效果、许可或正式评级证明。 |
|
||
| 19 | 连接规则 | 推理桥梁：证据命题：固定Python脚本由名称和路径创建目录树、模板与示例文件，并在目标目录已存在时拒绝创建。推理根据：目录/模板初始化只产生待编辑的骨架；它不蕴含新Skill已经具有完整语义或通过验证。由于静态源码只支持生成流程和前提，不支持生成物的语义验收，因此第18项关于区分初始化程序、模板输入、文件输出和后续完善/校验的局部规则。成立边界：第17项限定为“需Python运行时、可写目标路径和符合约定的skill名；目标目录若已存在会拒绝创建；后续内容须按Skill规范完善并校验；结论限定于第5项绑定的源码修订和说明，不扩展到未观察版本或实际部署”；不据此外推未观察效果、许可或正式评级。 |
|
||
| 20 | 依据 | 依据：来源ID `S23`；路径 `.github/tools/external/claude-official-skills/skills/skill-creator/scripts/init_skill.py`；选区SHA-256 `f3ef6ff82946a9596d5cacfc1ed0405765187e5ffec5a4ede6c15f5e8dd248dd`；修订 `1ed29a03dc852d30fa6ef2ca53a67dc2c2c2c563`；第5项载完整出处；对应第13项，边界按第17项。快照/静态仅支持记录，不代表独立核验或效果/许可/评级证据。 |
|
||
|
||
<a id="v0-faqi-faqi-codex-config-installer-2dcddf43"></a>
|
||
### Codex配置安装与恢复脚本
|
||
|
||
| 序号 | 说明项 | 内容 |
|
||
|:---:|:---|:---|
|
||
| 1 | 概念 | 对配置资产进行备份安装和恢复的历史脚本工件 |
|
||
| 2 | 术语 | Codex配置安装与恢复脚本 |
|
||
| 3 | 定义 | 已退役的历史安装脚本：从本地目录或配置的URL取safe/power资产，备份目标文件，安装配置并生成恢复脚本。它不是Codex CLI，也不提供账号授权；当前不作为可执行入口。 |
|
||
| 4 | 条目注释 | 编者注（据本条固定来源与既有说明归纳）：power可能开启更高权限；dry-run仍有临时目录动作，不能解释为零文件系统副作用。 |
|
||
| 5 | 来源 | 登记固定源码S06（历史revision `0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2`，install.sh lines 43–100及其选择SHA）和支持文档S05（同revision README lines 1–78）；仅静态阅读固定归档内容。退役状态来自当前法器登记/说明，不将历史README中的命令视作现行入口。 |
|
||
| 6 | 为什么 | 历史README描述的用途是把公开配置基线安装到Codex Home并支持备份/恢复；为何最初选择脚本而非手动配置未记录。用途说明不构成再次运行或信任远端内容的建议。 |
|
||
| 7 | 怎么做 | 历史README展示默认safe、显式`--profile power`、`--codex-home`和restore命令；脚本还接受`--dry-run`。该安装器已退役，本文仅解释固定源码，不执行curl、安装、备份或恢复。 |
|
||
| 8 | 扩展 | 历史脚本提供safe/power两个profile、`CODEX_HOME`/`--codex-home`、本地/远程资源基址、`--restore-latest`与`--dry-run`；power会启用更高权限设置，不能当成安全默认扩展。源码显示dry-run仍先创建临时目录并由trap清理，README的“无文件变化”不等于零文件系统动作。 |
|
||
| 9 | 关联信息 | 本轮v2说明为编辑归纳；历史用户审阅仅对当时说明有效，不自动覆盖此次新增或改写内容。未新增独立审查、运行或效果证据。<br><br>原关联记录（含历史意见）：<br>法器对象ID=faqi-codex-config-installer；本体类型=software-artifact；版本声明=未声明；本地入口=无（Codex配置安装与恢复脚本已退役；历史路径与来源见第5项）；当前运行实例/部署状态未在对象记录中声明。<br>Vibe Coding 重要性暂定：玄阶初级（grade_id=faqi-xuan-initial；状态=user_directed_provisional）；范围：Vibe Coding重要性：特定Agent接入配置；分级依据：降低特定Agent初始配置成本，但只服务候选运行时且可手工替代；不属于核心模型推理或执行闭环。不代表效能评级、运行结果或质量结论。<br>既有关系记录：未记录对象关系。<br>来源ID：S06, S05。<br>与Codex CLI配置文件、AGENTS文本和Codex Home有关；配置与Agent指令不是CLI本身，profile不证明账户、安装版本或审批行为。对象及当前绑定已按退役状态记录。 |
|
||
| 10 | 相关图书 | 固定脚本与README没有提供直接关联的作者、书名、版次或章节；配置文件和CLI文档不自动构成本条图书，本项不列书目。 |
|
||
| 11 | 它要解决什么问题？ | 历史脚本针对将选定Codex配置写入指定Codex Home并保留恢复副本的操作；是否适配当前Codex版本、配置合同和用户环境未知，且该实现已退役。 |
|
||
| 12 | 为什么这样设计？ | 源码结构先选择profile与目标目录，再备份原配置、写恢复脚本、获取模板并安装；这是可观察控制流。README宣称备份/恢复用途，但无法证明当时的设计动机或实际恢复可靠性。 |
|
||
| 13 | 内部如何实现？ | 脚本解析profile/home/restore/dry-run；从本地目录复制或curl取文件；保存两份原配置或缺失标记；生成restore.sh；替换LATEST链接/目录；最后以权限0600安装模板。源码还会删除已有LATEST路径，恢复缺失标记时会删除目标文件。未执行。 |
|
||
| 14 | 付出了什么代价？ | 安装会读写用户Codex Home、创建备份及恢复脚本、联网获取模板并覆盖配置；dry-run也会创建临时目录再清理。源码中的`rm -rf "$LATEST_LINK"`和恢复时`rm -f`是明显副作用风险，不代表已发生；没有运行验证。 |
|
||
| 15 | 比较不同技术与方法。 | 历史README给出safe与power配置差异：safe不启用danger-full-access或approval_policy=never；power显式开放高权限。与手动安装相比脚本集中备份/安装流程，但增加远程来源与覆盖面；未对当前替代方案做比较。 |
|
||
| 16 | 提炼共同规律。 | 编辑归纳：配置自动化需要先明确目标路径、保存原状态、显示副作用并验证恢复；只存在恢复脚本不证明可正确回滚。该规律由本脚本控制流提炼，不推广为测试结论。 |
|
||
| 17 | 明确这些规律成立的前提与适用条件。 | 仅适用于与固定源码一致的历史配置结构、正确Codex Home、可访问且可信的模板来源和合适文件权限；真实恢复还依赖备份完整、LATEST指向正确及目标文件状态。该脚本已退役，不代表当前Codex配置支持或应使用。 |
|
||
| 18 | 结论 | 结论（限第17项条件）：编辑归纳：配置自动化需要先明确目标路径、保存原状态、显示副作用并验证恢复；只存在恢复脚本不证明可正确回滚。该规律由本脚本控制流提炼，不推广为测试结论。<br>非效果、许可或正式评级证明。 |
|
||
| 19 | 连接规则 | 推理桥梁：证据命题：固定脚本既保存备份并生成restore.sh，也会替换LATEST路径，恢复缺失标记时可删除目标文件；未运行。推理根据：回滚成立依赖备份完整、目标状态与LATEST指针准确；存在恢复脚本不是成功恢复的观察证据。由于源码显示回滚依赖多个状态条件，而本次没有恢复执行结果，因此第18项关于先明确路径/保存状态并真实验证恢复、不能把脚本存在当作可回滚证明的结论。成立边界：第17项限定为“仅适用于与固定源码一致的历史配置结构、正确Codex Home、可访问且可信的模板来源和合适文件权限；真实恢复还依赖备份完整、LATEST指向正确及目标文件状态。该脚本已退役，不代表当前Codex配置支持或应使用”；不据此外推未观察效果、许可或正式评级。 |
|
||
| 20 | 依据 | 依据：固定来源 `S06`（历史revision `0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2`，install.sh lines 43–100及其选择SHA）和支持文档S05（同revision README lines 1–78）；第5项载完整出处；对应第13项，边界按第17项。快照/静态仅支持记录，不代表独立核验或效果/许可/评级证据。 |
|
||
|
||
<a id="v0-faqi-faqi-skill-seekers-adapter-eb5e7e6f"></a>
|
||
### Skill Seekers本地运行适配脚本
|
||
|
||
| 序号 | 说明项 | 内容 |
|
||
|:---:|:---|:---|
|
||
| 1 | 概念 | 为固定上游CLI设置Python环境并转交执行的适配程序 |
|
||
| 2 | 术语 | Skill Seekers本地运行适配脚本 |
|
||
| 3 | 定义 | 工作性定义：一种设置虚拟环境或PYTHONPATH并以exec转交固定Skill Seekers CLI的历史本地适配脚本，未执行验证。 |
|
||
| 4 | 条目注释 | 编者注（据本条固定来源与既有说明归纳）：适配脚本自身不联网或安装，但被转交的上游命令可能有相应副作用；封装不等同于上游核心。 |
|
||
| 5 | 来源 | 固定实现/佐证来源记录：{<br> "id": "S10",<br> "purpose": "implementation",<br> "path": ".github/skills/auto-skill/scripts/skill-seekers.sh",<br> "repository": ".",<br> "revision": "0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2",<br> "sha256": "fdbf73b1faa1a0f445663b5c7c1c9792bbfb6dcdf5f5308198503e14ea0c64dc",<br> "lines": [<br> 28,<br> 66<br> ],<br> "selection_sha256": "f678142dddda161372feb5c5af96bbbf5e1b3e76b9e2c7dc905a4d1ba18070f2"<br>}；{<br> "id": "S07",<br> "purpose": "support",<br> "path": ".github/skills/auto-skill/README.md",<br> "repository": ".",<br> "revision": "0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2",<br> "sha256": "2fd869316c0469d9c4079cd9a19c41698b501bca6ddd2b6cc03617e3f96218f0",<br> "lines": [<br> 1,<br> 21<br> ],<br> "selection_sha256": "2fd869316c0469d9c4079cd9a19c41698b501bca6ddd2b6cc03617e3f96218f0"<br>}<br>本地入口记录：{<br> "path": ".github/skills/auto-skill",<br> "objects": [<br> "faqi-auto-skill-create",<br> "faqi-auto-skill-validate",<br> "faqi-skill-seekers-adapter"<br> ],<br> "sources": [<br> "S07",<br> "S08",<br> "S09",<br> "S10"<br> ],<br> "boundary": "Skill说明/规约与三个独立入口脚本分离，不把整Skill包登记成一件软件。",<br> "pending": [<br> "其他辅助模块未逐模块登记，不能将本次选区称为全包能力审查。"<br> ]<br>}<br>重要性分级记录：{<br> "subject_id": "faqi-skill-seekers-adapter",<br> "grade_id": "faqi-xuan-initial",<br> "assignment_status": "user_directed_provisional",<br> "scope": "Vibe Coding重要性：Skill Seekers本地适配入口",<br> "basis": "便于调用特定知识转技能工具；范围受上游工具限制，可直接调用或人工替代。"<br>}<br>运行/部署状态未由此登记证明；版本或路径记录不等于本次运行验证。 |
|
||
| 6 | 为什么 | 在Vibe Coding流程中，本程序的具体用途是为本地Skill Seekers源码提供venv/PYTHONPATH启动适配。这是从固定README/源码可见功能解释使用场景，不声称它的历史采用动机或实际效果。 |
|
||
| 7 | 怎么做 | 固定脚本语法为skill-seekers.sh [--venv dir] -- <CLI参数>；检查linked src目录，优先使用指定venv的python，否则python3，随后exec模块入口。以上是固定材料描述的历史/静态用法，未执行程序。 |
|
||
| 8 | 扩展 | 可指定虚拟环境并透传上游CLI参数；引导脚本和实际上游功能是不同对象，不在此添加自动安装能力。 |
|
||
| 9 | 关联信息 | 本轮v2说明为编辑归纳；历史用户审阅仅对当时说明有效，不自动覆盖此次新增或改写内容。未新增独立审查、运行或效果证据。<br><br>原关联记录（含历史意见）：<br>法器对象ID=faqi-skill-seekers-adapter；本体类型=software-artifact；版本声明=未声明；本地入口=无（Skill Seekers本地适配脚本已退役；历史路径与来源见第5项）；相关Skill说明=.github/skills/skill（不同对象，不是该适配脚本）；当前运行实例/部署状态未在对象记录中声明。<br>Vibe Coding 重要性暂定：玄阶初级（grade_id=faqi-xuan-initial；状态=user_directed_provisional）；范围：Vibe Coding重要性：Skill Seekers本地适配入口；分级依据：便于调用特定知识转技能工具；范围受上游工具限制，可直接调用或人工替代。不代表效能评级、运行结果或质量结论。<br>既有关系记录：{<br> "subject": "faqi-skill-seekers-adapter",<br> "predicate": "requires",<br> "target_label": "链接源码中的skill_seekers.cli.main",<br> "related_object_id": "faqi-skill-seekers",<br> "evidence": "S10",<br> "boundary": "源码路径确由软链接指到选定submodule；这是静态加载意图，venv实际依赖、Python解析和运行结果未核。"<br>}<br>来源ID：S10, S07。 |
|
||
| 10 | 相关图书 | 本条所指是软件实现；固定来源是代码/README/Skill文档（见第7项），没有登记直接相关的图书书目，因此不把技术文档写成图书。 |
|
||
| 11 | 它要解决什么问题？ | 固定材料记录的目标用途是为本地Skill Seekers源码提供venv/PYTHONPATH启动适配；这说明该程序被设计/登记来处理的工作类型，不等于已验证的需求效果。具体输入、目标路径和副作用须按固定源码/README约定核对，不能把登记重要性当问题验收。 |
|
||
| 12 | 为什么这样设计？ | 源码可观察到的结构是：解析venv和分隔符，设置PYTHONPATH指向linked src，再以python -m skill_seekers.cli.main替换当前进程；脚本明确不自动安装依赖。这说明当前控制流如何分工，不推断源码未记载的作者历史设计意图。 |
|
||
| 13 | 内部如何实现？ | 解析venv和分隔符，设置PYTHONPATH指向linked src，再以python -m skill_seekers.cli.main替换当前进程；脚本明确不自动安装依赖。仅为固定源码静态说明，不表示已运行或完整审查全部上游实现。 |
|
||
| 14 | 付出了什么代价？ | 依赖本地源码路径、Python解释器和预先安装的依赖；环境变量改变子进程导入搜索路径，调用后直接交出控制权。未执行程序，也没有资源/性能实测。 |
|
||
| 15 | 比较不同技术与方法。 | 相对全局安装CLI，该适配让调用指向仓内源码并可选择venv；也增加路径/环境维护责任，不证明依赖隔离完备。 |
|
||
| 16 | 提炼共同规律。 | 从本程序可归纳的局部规则是：为本地Skill Seekers源码提供venv/PYTHONPATH启动适配时必须区分程序入口、输入资产和输出/副作用；本条只总结该固定实现边界，不推广为所有工具的效能规律。 |
|
||
| 17 | 明确这些规律成立的前提与适用条件。 | linked src目录必须存在；venv可选，调用参数需放在--后；本脚本不联网、不安装包，后续CLI是否联网取决于上游命令；结论限定于第5项绑定的源码修订和说明，不扩展到未观察版本或实际部署。 |
|
||
| 18 | 结论 | 结论（限第17项条件）：从本程序可归纳的局部规则是：为本地Skill Seekers源码提供venv/PYTHONPATH启动适配时必须区分程序入口、输入资产和输出/副作用；本条只总结该固定实现边界，不推广为所有工具的效能规律。<br>非效果、许可或正式评级证明。 |
|
||
| 19 | 连接规则 | 推理桥梁：证据命题：适配脚本设置venv/PYTHONPATH后exec上游CLI，并明确不自动安装依赖。推理根据：启动适配层控制的是本地解释器/导入路径和入口；上游CLI的能力、副作用与成功条件仍由上游具体命令决定。由于适配器边界没有替代上游合同、依赖或命令行为，因此第18项关于分别识别本地适配入口、linked源码及上游命令/副作用的局部规则。成立边界：第17项限定为“linked src目录必须存在；venv可选，调用参数需放在--后；本脚本不联网、不安装包，后续CLI是否联网取决于上游命令；结论限定于第5项绑定的源码修订和说明，不扩展到未观察版本或实际部署”；不据此外推未观察效果、许可或正式评级。 |
|
||
| 20 | 依据 | 依据：来源ID `S10`；路径 `.github/skills/auto-skill/scripts/skill-seekers.sh`；选区SHA-256 `f678142dddda161372feb5c5af96bbbf5e1b3e76b9e2c7dc905a4d1ba18070f2`；修订 `0a7fdf4ca54d2bb327dcdfc13e816da57ee9c4c2`；第5项载完整出处；对应第13项，边界按第17项。快照/静态仅支持记录，不代表独立核验或效果/许可/评级证据。 |
|