diff --git a/.github/AGENTS.md b/.github/AGENTS.md index 2d02d07b..057621fe 100644 --- a/.github/AGENTS.md +++ b/.github/AGENTS.md @@ -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；不得提交缓存、私有模板、真实会话、数据库或凭据。 diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index 61e197be..d6291d9b 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -7,7 +7,6 @@ # 仓库治理和自动化配置。 /.github/ @tukuaiai @tradecatlabs -/.github/workflows/ @tukuaiai @tradecatlabs /AGENTS.md @tukuaiai @tradecatlabs /README.md @tukuaiai @tradecatlabs /CONTRIBUTING.md @tukuaiai @tradecatlabs diff --git a/.github/extensions/AGENTS.md b/.github/extensions/AGENTS.md index 9274186d..7cd6009d 100644 --- a/.github/extensions/AGENTS.md +++ b/.github/extensions/AGENTS.md @@ -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原生扩展加载；只有符合原生扩展契约且经具体任务授权的模块才能执行。 diff --git a/.github/extensions/README.md b/.github/extensions/README.md index d9258aee..1827e68a 100644 --- a/.github/extensions/README.md +++ b/.github/extensions/README.md @@ -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`；没有复制第二份实现。 diff --git a/.github/extensions/check-directory-docs.py b/.github/extensions/check-directory-docs.py index 86e0aa20..bf9526b4 100644 --- a/.github/extensions/check-directory-docs.py +++ b/.github/extensions/check-directory-docs.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(): diff --git a/.github/workflows/ci.yml b/.github/extensions/github-actions-ci.yml similarity index 100% rename from .github/workflows/ci.yml rename to .github/extensions/github-actions-ci.yml diff --git a/.github/workflows/labeler.yml b/.github/extensions/github-actions-labeler.yml similarity index 100% rename from .github/workflows/labeler.yml rename to .github/extensions/github-actions-labeler.yml diff --git a/.github/workflows/welcome.yml b/.github/extensions/github-actions-welcome.yml similarity index 100% rename from .github/workflows/welcome.yml rename to .github/extensions/github-actions-welcome.yml diff --git a/.github/extensions/github-actions.md b/.github/extensions/github-actions.md new file mode 100644 index 00000000..5a7b2064 --- /dev/null +++ b/.github/extensions/github-actions.md @@ -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公网外链任务，不声称同等远端覆盖。 diff --git a/.github/workflows/AGENTS.md b/.github/workflows/AGENTS.md deleted file mode 100644 index 26fa784d..00000000 --- a/.github/workflows/AGENTS.md +++ /dev/null @@ -1,10 +0,0 @@ -# .github/workflows/ Agent 指南 - -本目录只放 GitHub Actions 工作流。 - -## 约束 - -- 不新增无法在本地解释的黑盒步骤。 -- 不在 workflow 中写入密钥明文。 -- 修改 CI 后必须运行 `make test`，并在推送后查看 GitHub Actions 结果。 -- 外链检查配置优先修改仓库根目录 `.lychee.toml`，不要在 workflow 里堆长排除列表。 diff --git a/.github/workflows/README.md b/.github/workflows/README.md deleted file mode 100644 index 26600ee1..00000000 --- a/.github/workflows/README.md +++ /dev/null @@ -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 注入。 diff --git a/AGENTS.md b/AGENTS.md index 548164a4..c712a99b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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；本地校验及其余保护保留。 diff --git a/README.md b/README.md index 41d76f52..82fcad62 100644 --- a/README.md +++ b/README.md @@ -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标签规则（自动流程已停用） ```