← ClaudeAtlas

issue-archivelisted

归档已关闭/已修复的 issues,提取经验教训并同步更新 CLAUDE.md 和 spec/global。 当用户说"归档 issue"、"archive issues"、"清理已修复的 issue"、 "归档已关闭的 issue"、"整理一下 issues"、"把修好的 issue 归档了"时触发。 也适用于用户想要清理 spec/issues/ 目录或将已解决问题归档的场景。 如果 spec/issues/ 中有 Fixed/Closed/Done 状态的 issue 积压,应主动建议使用此 skill。
KonghaYao/peri · ★ 37 · AI & Automation · score 82
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:提炼领域级认