mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-11-02 12:06:14 +00:00
* 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 - 移除用户点名的八项程序与资料 * refactor: maintenance - 平铺共享模块并移除lib目录
4.9 KiB
4.9 KiB
.github/目录规则
根README.md是唯一主页,本目录禁止新增README.md。
三个资源域
| 目录 | 职责 | 入口 |
|---|---|---|
context/ |
既有资料、规则、文档、研究及数据 | context/README.md、context/AGENTS.md |
skills/ |
所有既有Skill指令和流程,统一治理 | skills/README.md、skills/AGENTS.md |
extensions/ |
既有小工具、程序、脚本和适配实现 | extensions/README.md、extensions/AGENTS.md |
对象在各域平铺;资料集合和原生程序内部结构不拆散。旧docs/assets/metadata/prompts/research/scripts/tools不再作为并行活动根目录。
维护脚本与共享库
校验和测试是仓库维护基础设施,不属于用户侧Extensions资源;本次直接平铺到.github/,不另建scripts目录或旧路径兼容壳。
| 类别 | 当前入口 |
|---|---|
| Markdown校验 | check-local-links.py、check-markdown-details.py、check-doc-structure.py |
| 目录与导航 | check-directory-docs.py、check-metadata.py、check-ai-citation.py |
| 数据与来源 | check-gongfa.py、check-external-resources.py、check-research-raw.py、check-source-facts.py |
| Wiki | check-wiki.py;仍只校验明确给定的本地checkout |
| 测试 | test-gongfa.py、test-gongfa-catalog.py、test-faqi-catalog.py、test-markdown-details.py、test-source-archive.py |
| 共享实现 | source_boundaries.py、taxonomy.py、source_archive.py、book_views.py直接平铺;供同级入口与原资料生成器共用,不保留lib包 |
| 依赖 | requirements-gongfa.txt、requirements-faqi.txt |
平铺共享模块
| 模块 | 职责 |
|---|---|
| source_boundaries.py | 原lib/__init__中的第三方、镜像与研究缓存边界;保留各检查器范围差异 |
| taxonomy.py | 读取原轻量YAML子集中的分类与文档导航 |
| source_archive.py | 严格读取JSON载荷,核对字节、模式、SHA、当前位置、当前绑定与隔离复原 |
| book_views.py | 复用既有链接规则及markdown-it-py,生成文集锚点、历史导航及目录,代码示例不改写 |
- 4个模块只保存一份,直接导入;不保留
.github/lib/目录、软链接、__init__兼容包或新的运行框架。 - 公共函数小而稳定,历史来源/选区与当前实现绑定不能混同;不增加模型客户端或独立注册框架。
- 导入阶段不写文件、不联网、不执行目标程序;book_views只加载本仓链接检查器的规则函数。
- source_archive在显式调用时读取资料;export_documents只向调用方指定的新隔离目录复原,拒绝越界、软链接及敏感路径,不恢复旧运行目录。
- 复用标准库、原YAML子集、既有slug规则及markdown-it-py,不自研解析器;原字节、控制字符、读取预算、归属和并行变化保护不变。
- 修改后先运行相关协议及
make test-source-archive;最终完整make test按根AGENTS执行,不因路径调整削弱断言。
3个sync与1个fetch入口仍在Extensions,本次没有迁移它们。保持原校验范围和断言,同步Makefile、真实ROOT、导入与隔离夹具;从其他cwd调用不能误判仓库根。 归档Actions定义保持历史字节,不能当作仍有效的新路径调用;迁移Python脚本不恢复自动CI。
平台入口
ISSUE_TEMPLATE/、CODEOWNERS、FUNDING.yml、PULL_REQUEST_TEMPLATE.md、SECURITY.md、WIKI.md、labeler.yml、lint_config.json保留现有位置;用户本次点名workflows,不扩改其他协作入口。
workflows/已退役,不再作为平台例外;禁止重建目录、符号链接或兼容壳。原3个定义以github-actions-*.yml在Extensions平铺,说明见extensions/github-actions.md。- 自动CI、Labeler和Welcome不再触发;本地校验/测试由根Makefile调用同级维护脚本,资料维护仍调用Extensions入口,不把空远端检查当CI成功。
- CODEOWNERS仍由
@tukuaiai、@tradecatlabs覆盖,仅迁移路径,不改变审批或豁免资格。 - 原自动化定义逐字节保全,不执行或读取其secret表达式;恢复自动化须显式授权,不能只搬回路径而忽略权限、输入及检查生产者。
- 审批Ruleset25244224的
tradecatlabs豁免只用于其自己的PR;其他PR仍须有效批准。仅退役两套保护中已停用的markdown-lint/link-checker;签名、PR、线性历史及其它保护不变,不伪造审核。 - Issue/PR模板保持协作职责,长期规则写根AGENTS或资源域AGENTS,不塞入模板与CI。
- 固定来源使用Extensions下四个Gitlink;不得提交缓存、私有模板、真实会话、数据库或凭据。
验证
从仓库根运行相关make lint、make check-links、make check-directory-docs及受影响协议检查,最终完整测试以根AGENTS为准。