johnQ
c6ef6820e4
skill-gate / gate (pull_request) Waiting to run
- scripts/scheduled-task.sh：daily/weekly/monthly 只做确定性动作，需模型判断的部分生成 queue 文件 - scripts/install-schedulers.sh：装成用户级 launchd（daily 07:20 / weekly 周一 10:00 / monthly 1 日 10:00） - .gitea issue/PR 模板：新技能提案走同一套 SCOPE 门槛问题 - README 一键部署 2 步 → 4 步；MAINTENANCE 增加定时任务一节与边界说明
71 lines
4.9 KiB
Markdown
71 lines
4.9 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**。
|
||
|
||
### 继续推进（2026-11-01）
|
||
|
||
- 新增 beta 技能 `diagnosing-bugs`（难查 bug 诊断纪律：先建红循环再推理），补齐 evals 与四段式文档；路由表同步。
|
||
- 新增 `scripts/monthly-review.sh`：一条命令跑月度审阅（覆盖率 / 扫描 / 第三方 / catalog / description 异常）。
|
||
|
||
### 治理落地：定时任务与提案入口（2026-11-01）
|
||
|
||
- 新增 `scripts/scheduled-task.sh`：`daily` / `weekly` / `monthly` 三个确定性任务，只跑门禁、扫漂移、生成队列；需要模型判断的部分（真跑 evals、审阅 routing）生成 queue 文件交 agent。
|
||
- 新增 `scripts/install-schedulers.sh`：把节拍装成 macOS 用户级 launchd（`com.pipexerp.ai-proj-skill-{daily,weekly,monthly}`），不再依赖会话提醒；支持 `--status` / `--run` / `--uninstall`。
|
||
- 新增 `.gitea/issue_template/new-skill.md`、`.gitea/issue_template/config.yaml`、`.gitea/pull_request_template.md`：提案与 PR 走同一套 SCOPE 门槛问题。
|
||
- `README.md` 一键部署从 2 步改为 4 步（补 git hooks 与定时任务）；`MAINTENANCE.md` 增加「定时任务」一节，写明脚本只做确定性动作的边界。
|
||
- `.gitignore` 排除定时任务产出（`reports/skill-health/`、`reports/monthly/`、`reports/_scheduler/`、`reports/evals/queue-*.md`）。
|
||
- 新增 `scripts/evals-status.py` 与 `reports/evals/TEMPLATE.md`：evals 覆盖率与回归报告模板。
|
||
- `skill-creator` 实战记录 #1：用标准流程新建 `diagnosing-bugs`（beta，待观察后晋升）。
|