vibe-coding-cn/.github/extensions/README.md

Extensions：既有程序与小工具

字多不看

这里统一放原有程序、脚本、检查器及适配代码；每个既有程序或独立脚本在本域平铺，程序内部源码结构不拆散。 这里的Extensions不是Pi原生扩展的同义词；不能把整个目录交给Pi的-e加载。

快速导航

既有对象	入口与用途
auto-tmux	原终端自动化脚本；指令见同名Skill
Skill Seekers	固定上游源码；本地适配入口为skill-seekers.sh及其bootstrap/import/update脚本
Claude官方Skills源	单一固定上游树；16个既有Skill由Skills域引用
tmux、oh-my-tmux	原固定源码与配置仓库；不是自动安装或启用
提示词转换	原Excel、Markdown、JSONL转换程序
Codex配置	原配置与安装/恢复脚本；使用前核对副作用与凭据边界
chat-vault	原聊天保存程序；不得随仓保存真实会话和数据库
my-nvim、MCPlayerTransfer、图片转PDF	保留原程序；文件归类不解除法器原有范围排除
HTML工具原说明	clean_epub_css.html、markdown-bianjiqi.html、task card generator.html、xhs graphic production - 1.0.html、xhs graphic production.html

现有独立脚本还包括create-skill.sh、validate-skill.sh和引用原上游的init_skill.py；没有复制第二份实现。

完整细粒度目录（点击展开/收起）

• 使用方式
• 正文
• 检查与维护入口
• 依赖与执行边界

使用方式

先读具体程序的README和来源，再按任务显式调用。Python脚本从仓库根运行；现有Shell脚本可用bash .github/extensions/<脚本名>调用。 程序只存一份；Skill中的指令引用这里，不复制执行实现。Pi Agent使用原生工具和模型选择，不新增运行器或模型HTTP客户端。

正文

检查与维护入口

范围	既有脚本与入口
Markdown	check-local-links.py、check-markdown-details.py、test-markdown-details.py；make lint/check-links/check-details/test-details
结构与索引	check-doc-structure.py、check-directory-docs.py、check-metadata.py、sync-doc-toc.py
功法	check-gongfa.py、sync-gongfa-catalog.py、test-gongfa.py、test-gongfa-catalog.py
法器	sync-faqi-catalog.py、test-faqi-catalog.py
引用与资源	check-ai-citation.py、check-external-resources.py
研究与来源	check-research-raw.py、check-source-facts.py、fetch-research-raw.py
Wiki	check-wiki.py；make check-wiki WIKI_DIR=<本地checkout>
迁移数据契约	test-source-archive.py；lib/source_archive.py读取原始载荷，lib/book_views.py生成阅读导航

迁移新增的资料读取与测试是上述既有总表的必要维护支撑，不是新业务工具。 共享库职责见lib。完整本地检查为make test；它不执行被审第三方程序，也不证明运行、效果或许可。

依赖与执行边界

检查器使用Python3；功法、法器和资料档案维护使用Python3.10+，依赖分别见requirements-gongfa.txt、requirements-faqi.txt。 复用jsonschema、PyYAML、tabulate、markdown-it-py；转换程序另用其原有requirements。Markdown lint使用Node22+及固定的markdownlint-cli0.48.0。

来源树保持原Git修订。安装、抓取、上传、发布、修改配置和终端注入均有独立副作用，不因移入本域得到授权。 凭据仅从受信来源在运行时注入，不提交真实会话、数据库、API密钥、环境文件或私有模板。