ai-proj-helper/CHANGELOG.md

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