Name: v1.5.5-beta
Author: ke25019

Imported from ke25019/bili-title-filter (legacy/v1.5.5-beta/AGENTS.md). Install upstream with npx skills add ke25019/bili-title-filter --skill v1.5.5-beta. Copyright stays with the author.

协作约定（本仓库的开发规范）

本文件记录本项目的开发与调试约定，供人类贡献者与 AI 助手共同遵守。

1. 绝不影响使用者的正常使用（最高优先级）

真实浏览器调试必须先征得同意。 启动任何浏览器实例（哪怕是 --headless=new）之前，必须先问一句并得到明确同意，不要"顺手跑一下"。

原因：使用者本机正在使用 Edge。曾经出现过两种真实事故：

事故	后果	正确做法
用 `Get-Process msedge \| Stop-Process -Force` 收尾	杀掉使用者所有 Edge 窗口与标签页	只用 `tests/browser-harness/safe-edge.ps1 -Action stop`，它只结束命令行带专属 profile 的进程
启动测试实例时漏加 `--disable-sync`	使用者的扩展配置被同步进测试实例，测试中的改动也可能同步回其账号	始终带 `--disable-sync`，并固定使用 `%TEMP%\bf-test-edge` 独立 profile

其它同类要求：

不修改使用者默认 profile（...\Microsoft\Edge\User Data）下的任何内容
不写注册表、不改系统设置、不动使用者目录之外的路径
测试产物只放在 %TEMP% 与仓库内，用完清理

2. 改动前先复现，不靠猜

本项目的多数问题都出在"按猜测改选择器/加补丁"，正确顺序是：

先用 tests/ 的 jsdom 用例复现（结构类问题）
jsdom 测不出来的（真实 DOM、布局回流、占位块、尺寸相关）→ 征得同意后用 tests/browser-harness/ 抓真实数据与截图
拿到证据再改，并把该场景补成回归用例

3. 安全阀原则

内容脚本涉及页面布局，任何"可能把整块区域隐藏/遮蔽"的动作都必须有安全阀，无法确认时宁可不屏蔽：

容器内部还装着别的卡片 → 判定为列表，放弃
尺寸超过 1200×800 或视口面积 35% → 放弃
尺寸为 0（隐藏元素）→ 放弃
命中加载哨兵（load-more-anchor 等）→ 只做 visibility:hidden，保留布局盒，确保站点仍能加载

4. 版本与发布流程

manifest.json 的 version 升版本号（如 1.1.5）
三个 README 同步更新：README.md（语言导航）、README.zh-CN.md、README.en.md —— 含功能说明、更新日志、校验项计数
把上一个版本用 git archive <tag> --prefix=legacy/<版本>/ -o x.zip -- . ":(exclude)legacy" 归档到 legacy/（必须排除 legacy 自身，否则会递归膨胀）
打包：manifest.json 必须在 zip 根目录，且不含 legacy/、tests/； _locales/ 必须打进去（扩展商店靠它识别语言），manifest 的 default_locale 也要在；本地化后的文案有长度上限：name ≤ 45 字符、description ≤ 132 字符（Edge 商店的 Description 上限是 190，Chrome 更严，按 132 卡就不会被商店打回）
提交 → 打标签 vX.Y.Z-beta → 推送 main 与标签
在 GitHub 建 Release（预发布），上传 zip 附件，并实测附件可下载

5. 文档与语言

中文文档：README.zh-CN.md；英文文档：README.en.md；README.md 只做语言导航
代码注释、提交信息用中文；变量与函数名用英文
涉及实测结论时，把测到的真实类名/尺寸/数量写进注释与文档，便于日后核对

6. 校验项计数要一致

改动测试后，README.md、README.zh-CN.md、README.en.md、tests/README.md 里的校验项数量必须一起更新（可通过 cd tests && npm test 得到准确数字）。

7. PowerShell 注意

写 .ps1 脚本给 Windows PowerShell 5.1 使用时，文件必须带 UTF-8 BOM，否则中文会乱码并报语法错误
用 [System.IO.File]::WriteAllText($path, $text, (New-Object System.Text.UTF8Encoding($true))) 写带 BOM 的文件
读文件统一显式指定 [System.Text.Encoding]::UTF8，不要用 Get-Content 的默认编码

Install v1.5.5-beta and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "ke25019-bili-title-filter-v1-5-5-beta", "kind": "skill", "name": "v1.5.5-beta", "description": "本文件记录本项目的开发与调试约定，供人类贡献者与 AI 助手共同遵守。", "publisher": "ke25019", "version": "1.0.0", "capabilities": { "domains": [ "coding", "math" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "本文件记录本项目的开发与调试约定，供人类贡献者与 AI 助手共同遵守。" ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/ke25019/bili-title-filter", "path": "legacy/v1.5.5-beta/AGENTS.md", "ref": "b8f083c2aef7832fc8815be3c7ae455eb4908ff6", "url": "https://github.com/ke25019/bili-title-filter/blob/b8f083c2aef7832fc8815be3c7ae455eb4908ff6/legacy/v1.5.5-beta/AGENTS.md", "key": "ke25019/bili-title-filter/legacy/v1.5.5-beta/AGENTS.md" } }, "instructions": "# 协作约定（本仓库的开发规范）\n\n本文件记录本项目的开发与调试约定，供人类贡献者与 AI 助手共同遵守。\n\n---\n\n## 1. 绝不影响使用者的正常使用（最高优先级）\n\n**真实浏览器调试必须先征得同意。** 启动任何浏览器实例（哪怕是 `--headless=new`）之前，\n必须先问一句并得到明确同意，不要\"顺手跑一下\"。\n\n原因：使用者本机正在使用 Edge。曾经出现过两种真实事故：\n\n| 事故 | 后果 | 正确做法 |\n| --- | --- | --- |\n| 用 `Get-Process msedge \\| Stop-Process -Force` 收尾 | **杀掉使用者所有 Edge 窗口与标签页** | 只用 `tests/browser-harness/safe-edge.ps1 -Action stop`，它只结束命令行带专属 profile 的进程 |\n| 启动测试实例时漏加 `--disable-sync` | 使用者的扩展配置被同步进测试实例，测试中的改动也可能同步回其账号 | 始终带 `--disable-sync`，并固定使用 `%TEMP%\\bf-test-edge` 独立 profile |\n\n其它同类要求：\n\n- 不修改使用者默认 profile（`...\\Microsoft\\Edge\\User Data`）下的任何内容\n- 不写注册表、", "cost": { "context_tokens": 557 } }

v1.5.5-beta

About

协作约定（本仓库的开发规范）

1. 绝不影响使用者的正常使用（最高优先级）

2. 改动前先复现，不靠猜

3. 安全阀原则

4. 版本与发布流程

5. 文档与语言

6. 校验项计数要一致

7. PowerShell 注意

Install v1.5.5-beta and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews