johnQ
7b221cc767
skill-gate / gate (push) Waiting to run
- 24 个技能补齐 evals（正常/边界/失败恢复）与 docs/skills/*.md - 覆盖 dev 类、发布 runbook、karpathy 守则、PR/清单等 - coverage: 24 -> 0（40 个 promoted+model-invoked 全覆盖）
56 lines
3.4 KiB
Markdown
56 lines
3.4 KiB
Markdown
# Changelog
|
||
|
||
## Unreleased — 2026-10-31
|
||
|
||
### 新增
|
||
|
||
- 技能治理：`SCOPE.md` 收录门槛 + `.out-of-scope/` 拒绝档案。
|
||
- 生命周期分桶（`promoted` / `beta` / `deprecated`）与调用模式（`model-invoked` / `user-invoked`）。
|
||
- `scripts/validate-skills.py`：规范/大小/引用/调用模式/文档校验。
|
||
- `scripts/generate-catalog.py`：生成可审阅的 `catalog.json`。
|
||
- `scripts/scan-skill.sh` + `scripts/scan-allowlist.txt`：入库前安全扫描。
|
||
- 新技能（beta）：`skill-creator`、`ai-proj-helper-entry`、`verification-before-completion`。
|
||
- `install-skills.sh`：`--agent dsh`、`--link`、`--audit`、`--include-beta`、`--no-validate`。
|
||
|
||
### 变更
|
||
|
||
- 18 个命令型技能转 `user-invoked`（biz/integration/dev-android|ios|pda/publish/发布链），目录预算减少 18 项。
|
||
|
||
- `dev-review`：增加「接收与响应评审意见」。
|
||
- `req-design`：增加「任务依赖边（blocking edges）」。
|
||
- `agent-swarm`：增加「并行编排流程」。
|
||
- `dev-test`：增加「TDD 循环」。
|
||
- `generate-marketplace.py`：只发布 `promoted`，beta/deprecated 不随 marketplace 分发。
|
||
|
||
- 按 SCOPE 降级两个无增量技能：`verification-before-completion`、`ai-proj-helper-entry`（规则已在用户级 AGENTS.md），入口路由内容转为 `docs/skill-routing.md`。
|
||
|
||
### 清理（2026-10-31）
|
||
|
||
- 11 个超过 20KB 的 `SKILL.md` 拆分：大章节移入 `references/details.md`，正文全部回到 20KB 预算内。
|
||
- 7 处非标准 frontmatter 字段（`arguments`、`user_invocable`）移入 `metadata`。
|
||
- 修复 `req-dev` 的 4 条相对链接；校验器改为跳过行内代码，消除 `` 误报。
|
||
- `validate-skills.py`：23 个警告 → **0 个警告**。
|
||
|
||
### 清理（2026-10-31 第二批）
|
||
|
||
- `scripts/scan-skill.sh`：回环地址（localhost/127.0.0.1）不再算风险；命中后走允许清单。
|
||
- 11 个文件里的 `/Users/<机器名>` 绝对路径去环境化（脚本改 `$HOME`，文档改 `~`）。
|
||
- 允许清单登记 6 类运维环境地址与示例占位符（非凭据），附理由。
|
||
- 安全扫描：57 个警告 → **0 个警告、0 个高危**。
|
||
- 新增 `.gitea/workflows/skill-gate.yml`：PR/main 跑 `validate --strict` + `scan` + `catalog --check` + 安装器测试。
|
||
|
||
- 新增 `MAINTENANCE.md`：技能维护节奏（每日漂移、每周 evals 抽样、每月目录审阅、每季度治理复核）。
|
||
|
||
### 治理增强（2026-11-01）
|
||
|
||
- 新增 git 门禁：`hooks/git/pre-commit`（validate --strict / scan / catalog --check）+ `pre-push`（安装器测试），`scripts/install-git-hooks.sh` 一键安装（Gitea Actions 无 runner，本地兜底）。
|
||
- `install-skills.sh` 支持 `--scope project --project-dir <根>`：装到项目 `.agents/skills`，独立状态文件。
|
||
- 新增 `scripts/scan-installed.sh`：扫描已装但非本仓库管理的第三方技能（当前 33 个，0 高危）。
|
||
- `generate-catalog.py` 增加 `has_evals` / `has_docs` 与 `coverage` 汇总；`validate-skills.py` 增加 `--coverage` 报告与路由表一致性检查。
|
||
- `SCOPE.md` 增加覆盖率路线图（3–4 周补齐 40 个技能的 evals 与文档）；`MAINTENANCE.md` 同步。
|
||
|
||
### 覆盖率阶段 2（2026-11-01）
|
||
|
||
- 补齐剩余 24 个技能（dev 类为主）的 `evals/evals.json`（各 3 条）与 `docs/skills/<name>.md`（四段式）。
|
||
- `--coverage`：40 个 promoted+model-invoked 技能的 evals 与文档缺口 **24 → 0**。
|