# Changelog

## 2026-11-01 — REQ 连续推进（continuous）模式

### 新增

- `req-workflow` 新增参考文档 `skills/references/continuous-mode.md`（中文）：连续模式的目标与边界、阶段循环（做事 → 留证据 → checkpoint → 自动 `/req next`）、门禁分级（hard / soft）、`.ai-proj/req-<id>.state.json` checkpoint 约定与恢复协议、停止格式、staging 段与冒烟验证、反例。
- `req` 与 `req-workflow` 的 `SKILL.md` 增加 continuous 模式说明：默认自动 `/req next`，自动终点 = staging 部署成功 + 冒烟验证通过；只有 hard 门禁（方案确认、PRD 评审通过、生产发布授权、force、密钥/权限缺失、范围变更）才停下。

### 变更

- 门禁分级落地：讨论摘要确认、部署范围确认改为 soft 门禁（无人值守下按默认策略继续，把「待用户确认」写入 checkpoint / REQ 备注）；「评审必须用户确认」「禁止自审批」保持 hard。
- 阶段切换新增 checkpoint 约定：每次 `/req next` 前后写 `.ai-proj/req-<id>.state.json`，新会话先读 checkpoint、复核 evidence 再按 `next_command` 继续。
- 版本：`req-plugin` 2.1.0 → 2.2.0；`req-workflow-plugin` 1.0.0 → 1.1.0。
- `docs/skill-routing.md` 补 `req` / `req-workflow` 的 continuous 模式指引；`catalog.json` 重新生成。

## 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，待观察后晋升）。