mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-11-02 13:46:59 +00:00
tradecatlabsandGitHub
0920cd4c59
* 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目录
63 lines
4.9 KiB
Markdown
63 lines
4.9 KiB
Markdown
# `.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](source_boundaries.py) | 原lib/__init__中的第三方、镜像与研究缓存边界；保留各检查器范围差异 |
|
|
| [taxonomy.py](taxonomy.py) | 读取原轻量YAML子集中的分类与文档导航 |
|
|
| [source_archive.py](source_archive.py) | 严格读取JSON载荷，核对字节、模式、SHA、当前位置、当前绑定与隔离复原 |
|
|
| [book_views.py](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为准。
|