# 流程进化日志（pi-kb 源仓）

本目录记录 **@suwenguang/pi-kb** 包内流程进化（一轮一文件）。

业务仓 **不再** 使用 `knowledge/工程平台/KB工作流/反馈/` 或本地进化日志作为上游改包入口；反馈走 Gitee Issue（`/kb-feedback` 或 `/kb-session-retro`），进化在本仓完成并经 MR 合入。

## 1. 命名

`<YYYYMMDDHHMMSS>-<中文主题>.md`

时间戳：`TZ=Asia/Shanghai date +%Y%m%d%H%M%S`（14 位）。

## 2. 建议字段

```markdown
# <主题>

| 字段 | 内容 |
|---|---|
| 版本 | vX.Y（包内流程语义版本，与 npm package version 可不同） |
| 日期 | YYYY-MM-DD |
| commit | <hash，提交后回填> |
| MR | <url> |
| evomap_asset_ids | （可选）采用或回传的 asset_id 列表 |

## 改动文件
- …

## Issue 处置记录
- #N 采纳/拒绝/搁置：…
```

## 3. 贡献流程

1. `/kb-evolve-setup`（或手动 clone + `pi install <path> -l`）
2. （可选）`/kb-evomap-setup` 开启网络路径（默认关闭）
3. 源码仓 `/kb-evolve`（拉 `pi-kb-feedback` Issue；若启用则 search EvoMap）
4. push feature 分支 → `scripts/kb-gitee-issue.mjs mr` → `master`
5. 维护者合入后 bump `package.json` / `CHANGELOG.md` → `npm publish`
6. 业务仓 `pi update`

详见 [kb-feedback-gitee.md](../../skills/kb-workflow/references/kb-feedback-gitee.md)、[kb-evomap.md](../../skills/kb-workflow/references/kb-evomap.md)。