mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-11-02 12:26:36 +00:00
refactor: toolbox - 清除workflows残留并退役自动流程 (#152)
* refactor: toolbox - 收口Context Skills Extensions三域资源 * fix: toolbox - 重定向文集中的嵌套标签链接 * fix: toolbox - 保全被ignore遮蔽的原跟踪事实文件 * refactor: toolbox - 退役workflows残留并平铺原定义
This commit is contained in:
tradecatlabs
+5
-4
@@ -14,12 +14,13 @@
|
||||
|
||||
## 平台入口
|
||||
|
||||
`workflows/`、`ISSUE_TEMPLATE/`、`CODEOWNERS`、`FUNDING.yml`、`PULL_REQUEST_TEMPLATE.md`、`SECURITY.md`、`WIKI.md`、`labeler.yml`、`lint_config.json`保留GitHub原生位置，不算第四种资源。
|
||||
`ISSUE_TEMPLATE/`、`CODEOWNERS`、`FUNDING.yml`、`PULL_REQUEST_TEMPLATE.md`、`SECURITY.md`、`WIKI.md`、`labeler.yml`、`lint_config.json`保留现有位置；用户本次点名workflows，不扩改其他协作入口。
|
||||
|
||||
- 工作流只做本次必要路径同步，不改变触发、权限、原检查范围或分支保护；本地命令仍由根Makefile调用Extensions中的脚本。
|
||||
- `workflows/`已退役，不再作为平台例外；禁止重建目录、符号链接或兼容壳。原3个定义以`github-actions-*.yml`在Extensions平铺，说明见`extensions/github-actions.md`。
|
||||
- 自动CI、Labeler和Welcome不再触发；本地命令仍由根Makefile调用Extensions中的脚本，不把空远端检查当CI成功。
|
||||
- CODEOWNERS仍由`@tukuaiai`、`@tradecatlabs`覆盖，仅迁移路径，不改变审批或豁免资格。
|
||||
- 原欢迎Action仍使用`actions/first-interaction@v3`的`repo_token`、`issue_message`、`pr_message`，保留原平台secret、事件、权限及不checkout外部PR边界。
|
||||
- 审批Ruleset25244224的`tradecatlabs`豁免只用于其自己的PR；其他PR仍须有效批准。主Ruleset17185792及必需CI/签名保持不变，不伪造独立审核。
|
||||
- 原自动化定义逐字节保全，不执行或读取其secret表达式；恢复自动化须显式授权，不能只搬回路径而忽略权限、输入及检查生产者。
|
||||
- 审批Ruleset25244224的`tradecatlabs`豁免只用于其自己的PR；其他PR仍须有效批准。仅退役两套保护中已停用的`markdown-lint`/`link-checker`；签名、PR、线性历史及其它保护不变，不伪造审核。
|
||||
- Issue/PR模板保持协作职责，长期规则写根AGENTS或资源域AGENTS，不塞入模板与CI。
|
||||
- 固定来源使用Extensions下四个Gitlink；不得提交缓存、私有模板、真实会话、数据库或凭据。
|
||||
|
||||
|
||||
@@ -7,7 +7,6 @@
|
||||
|
||||
# 仓库治理和自动化配置。
|
||||
/.github/ @tukuaiai @tradecatlabs
|
||||
/.github/workflows/ @tukuaiai @tradecatlabs
|
||||
/AGENTS.md @tukuaiai @tradecatlabs
|
||||
/README.md @tukuaiai @tradecatlabs
|
||||
/CONTRIBUTING.md @tukuaiai @tradecatlabs
|
||||
|
||||
@@ -9,5 +9,6 @@
|
||||
- 原第三方源码、研究缓存与事实镜像维持各检查器原边界；不得忽略整个Extensions来掩盖自有工具错误。共享边界在`lib/__init__.py`。
|
||||
- 先用现有测试取得失败；新增测试只填实际行为缺口，保存真实输入、退出码和工件；最后完整`make test`只运行一次。
|
||||
- 不执行被审第三方程序、安装器、上传、抓取或排除服务来补造验证；不读真实凭据、会话或数据库。
|
||||
- API、命令和路径变化同步本域README、受影响Skill、根README/AGENTS、Makefile和活动导航。CI只变必要路径，不变触发、权限、保护或原覆盖。
|
||||
- API、命令和路径变化同步本域README、受影响Skill、根README/AGENTS、Makefile和活动导航。本地校验范围不随Actions退役缩减。
|
||||
- `github-actions-*.yml`是已退役的原自动化定义，逐字节保全，不在本域执行或自动加载；说明见`github-actions.md`。不得擅自恢复`.github/workflows/`或把本地结果冒充远端CI。
|
||||
- 此目录不能整体作为Pi原生扩展加载；只有符合原生扩展契约且经具体任务授权的模块才能执行。
|
||||
|
||||
@@ -18,6 +18,7 @@
|
||||
| [chat-vault](chat-vault/README.md) | 原聊天保存程序；不得随仓保存真实会话和数据库 |
|
||||
| [my-nvim](my-nvim/README.md)、[MCPlayerTransfer](MCPlayerTransfer/README.md)、[图片转PDF](XHS-image-to-PDF-conversion/README.md) | 保留原程序；文件归类不解除法器原有范围排除 |
|
||||
| [HTML工具原说明](html-tools-main.md) | `clean_epub_css.html`、`markdown-bianjiqi.html`、`task card generator.html`、`xhs graphic production - 1.0.html`、`xhs graphic production.html` |
|
||||
| [原GitHub Actions定义](github-actions.md) | `github-actions-ci.yml`、`github-actions-labeler.yml`、`github-actions-welcome.yml`；已停用，仅保全原定义 |
|
||||
|
||||
现有独立脚本还包括`create-skill.sh`、`validate-skill.sh`和引用原上游的`init_skill.py`；没有复制第二份实现。
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@ from lib import SOURCE_PREFIXES, VENDOR_SUBTREES, is_research_repository_snapsho
|
||||
|
||||
ROOT = Path(__file__).resolve().parents[2]
|
||||
REQUIRED_DIRS = list(map(Path, (
|
||||
'.github', '.github/ISSUE_TEMPLATE', '.github/workflows',
|
||||
'.github', '.github/ISSUE_TEMPLATE',
|
||||
'.github/context', '.github/context/assets', '.github/context/ai-citation',
|
||||
'.github/context/assets/datasets', '.github/context/assets/images', '.github/context/assets/templates',
|
||||
'.github/context/getting-started', '.github/context/gongfa', '.github/context/faqi',
|
||||
@@ -23,6 +23,7 @@ REQUIRED_DIRS = list(map(Path, (
|
||||
'.github/extensions/prompts-library/scripts',
|
||||
)))
|
||||
COLLECTION_DIRS = {Path('.github/context/gongfa'), Path('.github/context/faqi')}
|
||||
RETIRED_DIRS = (Path('.github/workflows'),)
|
||||
README_OPTIONAL_DIRS = {
|
||||
# GitHub repository pages can surface `.github/README.md` as an overview file.
|
||||
# Keep the root project README authoritative and use `.github/AGENTS.md` only.
|
||||
@@ -63,6 +64,11 @@ def repository_owned_dirs() -> list[Path]:
|
||||
def main() -> int:
|
||||
errors: list[str] = []
|
||||
|
||||
for rel_dir in RETIRED_DIRS:
|
||||
directory = ROOT / rel_dir
|
||||
if directory.exists() or directory.is_symlink():
|
||||
errors.append(f'{rel_dir}: 已退役目录不得重新创建')
|
||||
|
||||
for rel_dir in repository_owned_dirs():
|
||||
directory = ROOT / rel_dir
|
||||
if not directory.is_dir():
|
||||
|
||||
@@ -0,0 +1,23 @@
|
||||
# 原GitHub Actions定义（已停用）
|
||||
|
||||
用户要求清除workflows目录，因此原定义直接平铺至Extensions，`.github/workflows/`不再保留。
|
||||
GitHub不会自动发现本目录的定义；自动CI、PR打标签和首次贡献者欢迎均已停用，不是换路径后仍在运行。
|
||||
|
||||
## 原定义与职责
|
||||
|
||||
| 原定义 | 保全位置 | 历史职责 |
|
||||
|---|---|---|
|
||||
| CI | [github-actions-ci.yml](github-actions-ci.yml) | 原Markdown、本地导航/结构/索引与外链检查 |
|
||||
| Labeler | [github-actions-labeler.yml](github-actions-labeler.yml) | 原PR自动标签 |
|
||||
| Welcome | [github-actions-welcome.yml](github-actions-welcome.yml) | 原首次Issue/PR贡献者欢迎 |
|
||||
|
||||
3份YAML保持原字节，包括历史路径注释、事件、权限、Action版本及平台secret表达式；保全不是执行或重新授权。
|
||||
原目录规则已并入本域AGENTS，不保留第二份治理文件、空目录或符号链接。
|
||||
|
||||
## 本地检查与保护
|
||||
|
||||
- 从仓库根运行`make test`；其检查范围不缩减，也不自动执行以上定义。
|
||||
- 主Ruleset和main经典保护仅移除已无Actions生产者的`markdown-lint`、`link-checker`必需检查。
|
||||
- 签名、线性历史、PR、禁止强推/删除及原审批规则保留，不伪造成功checks或独立审核。
|
||||
- 原目录不得重建；如需恢复自动化，必须显式授权，并共同恢复原生发现路径和对应检查生产者。
|
||||
- 外链规则仍在仓库根`.lychee.toml`；本地`make test`不包含原Lychee公网外链任务，不声称同等远端覆盖。
|
||||
@@ -1,10 +0,0 @@
|
||||
# .github/workflows/ Agent 指南
|
||||
|
||||
本目录只放 GitHub Actions 工作流。
|
||||
|
||||
## 约束
|
||||
|
||||
- 不新增无法在本地解释的黑盒步骤。
|
||||
- 不在 workflow 中写入密钥明文。
|
||||
- 修改 CI 后必须运行 `make test`，并在推送后查看 GitHub Actions 结果。
|
||||
- 外链检查配置优先修改仓库根目录 `.lychee.toml`，不要在 workflow 里堆长排除列表。
|
||||
@@ -1,9 +0,0 @@
|
||||
# .github/workflows
|
||||
|
||||
GitHub Actions 工作流目录。
|
||||
|
||||
## 当前工作流
|
||||
|
||||
- `ci.yml` - 在 `main` 的 push / pull_request 上执行 Markdown lint、本地链接、docs 结构、目录治理、metadata、AI citation 和外链检查。
|
||||
- `welcome.yml` - 在 Issue / PR opened 时欢迎首次贡献者；`actions/first-interaction@v3` 的输入使用
|
||||
`repo_token`、`issue_message`、`pr_message`，令牌由 GitHub Actions 原生 secret 注入。
|
||||
@@ -14,7 +14,7 @@
|
||||
| `.github/context/` | 既有规则、知识、文档、数据、研究和参考资料；详见本域AGENTS |
|
||||
| `.github/skills/` | 2个自有与16个既有官方Skill指令，统一治理；代码引用Extensions |
|
||||
| `.github/extensions/` | 原程序、小工具、检查/生成/测试脚本与适配；不是全部可由Pi的`-e`加载 |
|
||||
| `.github/workflows/`、`ISSUE_TEMPLATE/`及固定配置 | GitHub原生平台入口，保留规定位置，不构成第四个资源域 |
|
||||
| `.github/ISSUE_TEMPLATE/`及固定配置 | 现有GitHub协作入口；本次仅退役workflows，不扩改其他平台配置 |
|
||||
| `Makefile` | 本地可重复命令入口 |
|
||||
| `.github/context/metadata/` | 导航、术语及历史路径映射；不重复登记或定义另一套本体 |
|
||||
| `.github/context/ai-citation/` | 当前AI引用语料与llms-full |
|
||||
@@ -46,7 +46,8 @@ Context的9个既有集合是`gongfa`、`faqi`、`getting-started`、`prompts`
|
||||
- 不修改`LICENSE`、`CODE_OF_CONDUCT.md`或`.env*`；不内联真实密钥、Token、cookie、私钥或账号配置。
|
||||
- 凭据仅从受信来源运行时注入，禁止从会话/日志/未知文件搜寻；所有输出先脱敏，不输出值、长度、摘要或前后缀。
|
||||
- 架构、命令与路径变化同步README、AGENTS、Makefile、活动调用方与索引；不把冻结来源中的旧路径误改成当前路径。
|
||||
- 工作流只在任务明确要求时修改；迁移只改必要调用路径，不改事件、权限、检查范围、签名或分支保护。
|
||||
- `.github/workflows/`已按用户要求退役，不得重建空目录、符号链接或兼容壳。原3份定义平铺为Extensions中的`github-actions-*.yml`，不是活动工作流。
|
||||
- 自动CI、Labeler和Welcome均停用；本地Makefile及检查范围不变。重新启用须显式授权，并同时核对原生目录和对应保护检查。
|
||||
- 注释、文档及新日志使用中文；代码标识英文。避免无价值封装、重复源码、猜测API和范围外重构。
|
||||
|
||||
## 验证
|
||||
@@ -69,7 +70,7 @@ Context的9个既有集合是`gongfa`、`faqi`、`getting-started`、`prompts`
|
||||
- 三域入口、入门README及两本文集维持标题→字多不看→快速导航→完整细粒度目录→使用方式→正文；维护规则留AGENTS。
|
||||
- 功法/法器生成视图的目录由其生成器维护；`sync-doc-toc.py`不能二次编辑生成文件。文档结构与来源SHA检查仍保留。
|
||||
- 改Mermaid须真实渲染。首页2025Q4–2026Q2甘特图是历史规划，不冒充当前进度或新承诺。
|
||||
- 本地总测试不等于远端CI：GitHub Actions仍选原lint/导航/结构/索引/引用和外链检查，不冒称新增全部协议测试覆盖。
|
||||
- 本地总测试不等于远端CI；当前GitHub Actions已停用，不得把本地成功或空检查列表称为远端CI通过。
|
||||
- `clean`、`clean-deps`有删除副作用，不作为测试执行。安装器和被排除程序也不为补证而运行。
|
||||
|
||||
## 首页与文档约定
|
||||
@@ -84,13 +85,14 @@ Context的9个既有集合是`gongfa`、`faqi`、`getting-started`、`prompts`
|
||||
- `main`是当前默认和贡献主线；`minimal`保留现有内容。旧`develop`及其他本地历史不自动合并、切换、重置或删除。
|
||||
- 用户已授权本仓修改验证后自动提交、推送、以精确PR/HEAD合并；后续暂停或仅本地指令优先，不重复询问发布许可。
|
||||
- 提交格式：`feat|fix|docs|chore|refactor|test: scope - summary`，签名提交；PR说明范围、动机、验证与未验证项。
|
||||
- 主Ruleset17185792无豁免：必需CI、签名、线性历史及禁止强推/删除保持不变。
|
||||
- 主Ruleset17185792无豁免：签名、线性历史、PR及禁止强推/删除保持不变。仅已停用的`markdown-lint`、`link-checker`从主Ruleset和main经典保护的必需检查中退役，避免等待不存在的生产者。
|
||||
- 审批Ruleset25244224默认1个有效批准；仅`tradecatlabs`（User288998340）有pull_request模式豁免，项目只允许它用于自己发起的PR。
|
||||
- 豁免按操作账号而非作者自动判断；合并他人PR仍核对有效批准，不伪造批准、成功checks或独立审核。
|
||||
- CODEOWNERS维护者仍为`@tukuaiai`、`@tradecatlabs`；它是路径审查入口，不替代保护。Code Owner/最近推送/额外审批不另加重复门槛。
|
||||
- 不为交付弱化保护或扩大豁免；流程例外按授权留痕。合并前核对精确HEAD、实际CI与签名，合并后读回主线及远端事实。
|
||||
- 不为交付临时弱化保护或扩大豁免；本次用户明确退役Actions及其对应检查单独留痕，其余保护不变。合并前核对精确HEAD、本地验证、签名及真实检查状态，合并后读回主线事实。
|
||||
- 不清理或删除工作树、引用与历史；若未来明确授权清理，先保全精确SHA、开放PR及恢复证据。
|
||||
|
||||
## 变更记录
|
||||
|
||||
三域重构将原资料、指令与程序重新归位；合并原入口的重复治理，保留原始资料与来源；不新增业务Skill、模型调用或已验证效果声明。
|
||||
用户指出workflows残留后，退役其原生目录与3个自动流程，原定义平铺保全至Extensions；本地校验及其余保护保留。
|
||||
|
||||
@@ -160,6 +160,7 @@ pi --skill .github/skills
|
||||
## 🗂️ 项目目录结构概览
|
||||
|
||||
资源只有三个域；下面列出域边界与Context的全部9个集合，不展开各原生包内部源码。完整对象分别在三个域的README中导航。
|
||||
原Actions定义已移入Extensions保全，自动CI、打标签及欢迎流程已停用；本地`make test`保留。
|
||||
|
||||
```
|
||||
.
|
||||
@@ -195,8 +196,7 @@ pi --skill .github/skills
|
||||
├── SECURITY.md # 安全政策
|
||||
├── FUNDING.yml # 赞助配置
|
||||
├── WIKI.md # GitHub Wiki 独立仓库说明
|
||||
├── labeler.yml # PR 标签规则
|
||||
└── workflows/ # GitHub Actions 工作流（含新贡献者欢迎）
|
||||
└── labeler.yml # 原PR标签规则（自动流程已停用）
|
||||
```
|
||||
|
||||
</details>
|
||||
|
||||
Reference in New Issue
Block a user