 study-tool
|
48e72ab1e7
|
docs: 发版流程拆成通用与项目两层
现象：AGENTS.md「发版本流程」里写死了本项目的文件名和命令（metadata.yaml、uv tool run
bump-my-version、uv.lock），换项目没法直接复用；手写那一行还出现了 `runm` 和 `etadata.yaml`
两处笔误。
根因：通用规则和项目实现细节混在同一节，规则文件承担了本该属于架构文档的内容。
边界：
- AGENTS.md「发版本流程」改成通用表述：确认后触发、CHANGELOG 整理、锁文件自检、发版工具一次
完成改版本 + 提交 + 打 tag、tag 查重、发版不构建；不再出现具体文件名和命令
- docs/architecture.md 新增「发版」一节，放本项目的三处版本文件、bump-my-version 命令、
CRLF + regex 的配置坑、改配置后先 dry-run
- docs/agent_workflow.md「项目契约和 Agent 行为规则分开」补上这次的证据，Seen 升到 2×
- 不改代码、不改版本号、不打 tag
运行了什么：git status 自查（只提交这 3 个文档文件）；提交时 pre-commit 跑 ruff / web typecheck / commitizen
没跑什么：没跑 bump-my-version 真实发版；没跑测试、没构建（本次无代码改动）
|
2026-11-01 21:22:56 +08:00 |
|
|
study-tool
|
d8808e64d9
|
docs: AGENTS.md 增加收尾提交规则，发版流程改为工具驱动一条线
现象：发版流程里「手动提交 + 手动打 tag」与 bump-my-version 的 commit = true / tag = true
冲突，真用工具会撞同名 tag；另外没有写清「何时提交、何时必须先提交」，导致为 1 行 uv.lock
单开了提交（4784ac0）。
根因：发版步骤是按手动流程写的，后来才配了自动提交 + 打 tag 的工具，两边没有对齐；提交时机
只散落在发版一节里。
边界：
- 新增「收尾（Commit）」：任务完成后自动提交，一个任务一个 commit；附带产物（如 uv.lock）
跟着产生它的任务走；重大变更（改依赖 / 表结构 / 规则文档 / 发版）开始前工作区必须干净；
发版本只在用户确认后触发
- 「发版本流程」改为：整理 CHANGELOG 并普通提交 → uv lock 自检 → 工作区干净后
uv tool run bump-my-version bump patch 一次完成改三处版本 + 提交 + 打 tag；不再手动 commit / tag
- docs/agent_workflow.md 记入三条：发版配置要 dry-run、发版只留一条线、附带产物不单开提交
- 不改代码、不改版本号、不打 tag
运行了什么：git status 自查（只提交这 2 个文档文件）；提交时 pre-commit 跑 ruff / web typecheck / commitizen
没跑什么：没跑 bump-my-version 真实发版；没跑测试、没构建（本次无代码改动）
|
2026-11-01 21:17:42 +08:00 |
|
|
study-tool
|
106818cfc2
|
docs: 消解 AGENTS.md 规则冲突，项目契约迁入架构文档
现象：AGENTS.md 里 5 处规则互相打架——逐次询问 vs 认领/提交/升版本；不构建 vs 前端必须
build；全部提交 vs 禁 add -A；每次提交 bump 版本号，而实际 24 次提交版本仍是 0.0.8。
docs/agent_board.md 没有 Agent 列，认领规则无法落地；docs/agent_workflow.md 是 0 字节；
docs/todo.md 与 docs/progress/todo.md 双账本漂移，旧文件还写 platforms/gdgxk.py。
根因：规则按「想防的事」逐条追加，没有回头消解冲突；项目契约和 Agent 行为混在同一个入口文件里。
边界：
- AGENTS.md 只留行为规则；日志 / 目录 / 插件契约指向 docs/architecture.md（两节内容已并入，未丢失）
- 版本号改为只在发版提交时 bump，普通提交不动
- 看板改四列表头，状态带时间戳「进行中 (MM-DD HH:mm)」，超 24h 可接管
- 删除 docs/todo.md；其中 2 条仍未修的代码问题已迁入 docs/progress/todo.md，待办按 待做 / 已知偏差 / 未验证 重排
- 不改代码、不改版本号、不打 tag
运行了什么：git status 自查（只提交这 6 个文档文件，uv.lock 是原有改动未提交）；提交时 pre-commit 跑 ruff / web typecheck / commitizen
没跑什么：没跑测试、没构建、没跑 pnpm build（本次无代码改动）
|
2026-11-01 20:06:23 +08:00 |
|
|
study-tool
|
aa48145557
|
feat: 故障推送 / 公需课自动重学 / 插件解耦，发版 v0.0.8
体检修复：启动日志不再打印 AUTH_TOKEN、密钥可清空、推送失败不占整段冷却、目录名与文案统一成 plugins/。
|
2026-11-01 17:47:22 +08:00 |
|