issue-archivelisted
Install: claude install-skill KonghaYao/peri
# issue-archive: Issue 归档与问题领域沉淀
将 `spec/issues/` 中已解决的 issue 归档到 `spec/archive-issues/`,从每个 issue 中提炼**问题领域认知**(而非零散 TRAP),更新到对应的 domain 文件。
## 归档条件
通过 Grep 扫描 `spec/issues/` 中所有 issue 的 `**状态**` 字段:
| 状态模式 | 归档 | 说明 |
|---------|------|------|
| `Verified` | 是 | 用户已验证通过(规范终态) |
| `Closed` | 是 | 已关闭 |
| `Fixed` | 是 | 已修复(旧 issue 兼容:`Fixed`、`Fixed + Verify`、`Fixed(待用户验证)`等变体) |
| `Done`/`已完成`/`Resolved`/`完成`/`verify` | 是 | 旧格式兼容 |
| `Open`、`Open (搁置)` | 否 | 仍需处理 |
| `Partial`、`Reopen` | 否 | 未完全解决 |
如果扫描结果为空(没有可归档的 issue),直接报告并结束。
## 工作流程
### 阶段一:扫描
1. 用 Grep 在 `spec/issues/` 中搜索 `**状态**` 行
2. 按上述规则筛选可归档 issue
3. 输出清单(标题 + 状态),直接进入归档
### 阶段二:领域识别与认知提炼
逐个 Read 可归档的 issue 文件,执行:
**步骤 1:识别所属领域**
从 issue 的标题、涉及文件、问题描述中识别属于哪个领域:
- `message-pipeline` — 消息渲染、事件处理、视图模型
- `agent` — ReAct 循环、工具系统、LLM 适配
- `tui` — TUI 渲染、交互、面板
- `mcp` — MCP 连接、工具桥接
- `storage` — 持久化、数据库
- `compact` — 上下文压缩
- `token-tracking` — Token 追踪
- `langfuse` — 可观测性
- 等等(参考 `spec/global/domains/` 现有列表)
**如果领域不存在**,创建新的 domain 文件 `spec/global/domains/<domain>.md`,使用标准模板:
```markdown
# <领域名称> 领域
## 领域综述
<一句话概括这个领域的核心职责>
## 核心流程
(后续通过 issue 归档逐步填充)
## 技术方案总结
| 维度 | 选型 |
|------|------|
(后续通过 issue 归档逐步填充)
---
## 相关 Feature
```
同时在 `spec/global/index.md` 的领域索引表中追加该领域。
**步骤 2:关键词提取**
从 issue 中提取 2-4 个**搜索关键词**,用于快速索引。关键词应选择:
- 技术术语:`HashMap 顺序`、`Prompt Cache`、`BaseMessage vs MessageViewModel`
- 错误模式:`缓存失效`、`维度混淆`、`并发竞争`
- 涉及概念:`reasoning_content`、`parking_lot::RwLock`、`RebuildAll`
**步骤 3:提炼领域级认