# 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 个警告**。