Devlab Ai Kit Miner

---
name: devlab-ai-kit-miner
description: Review completed dev sessions to decide whether work should be distilled into devlab-* assets (skills, CLI tools, MCP servers, loops, subagents, or knowledge cards). Based on base-session-ai-kit-miner, specialized for dev workflows (不局限于前后端，覆盖全栈研发场景). Triggers on "devlab-ai-kit-miner", "devlab skill miner", "研发复盘", "技能提炼", "沉淀决策".
---

# devlab-ai-kit-miner

## 用途

在一次较长的研发协作会话结束后，复盘本次工作中是否存在值得沉淀的资产。

基于 base-session-ai-kit-miner 的复盘能力，增加了：
- 研发场景特有的**多资产类型决策**（Skill / CLI / MCP / Loop / Subagent）
- `devlab-*` 命名规范
- 团队仓库 vs 项目级的沉淀位置决策
- 与 `harness-ai-kit` 工具链的集成指引

## 输入

- 已完成研发任务的对话记录、摘要或关键回合
- 本次 session 中与该任务相关的连续历史
- 最终产物（代码、文档、配置、命令记录）
- 执行过程中重复出现的步骤、判断、工具链或约束
- 可选：现有 Skill 清单（`harness-ai-kit/skills/` + `.claude/skills/`）

## 输出

- 是否建议沉淀的明确结论
- 建议的资产类型：Skill / CLI / MCP / Loop / Subagent / 知识卡片
- 建议的沉淀位置：项目级 / 团队共享
- 候选资产的最小规格草案
- 与现有 `devlab-*` 资产的关系（新增 / 补充 / 桥接 / 重复）
- 演进处置分类：`patch-existing` / `create-new` / `reject-local-only`；其中前两类才生成 `candidate/v1`，`reject-local-only` 只保留本地记录
- 已脱敏的 evidence 引用、基线 Skill 版本、最小变更摘要和建议评测 case

## 工作流

1. 确认复盘对象已完成，不把中途探索误判为可复用资产。
2. 从本次 session 历史中确认复盘边界（起始点、阶段总结、增量经验）。
3. 收集关键证据：最终交付物、反复执行的步骤、依赖稳定规则的判断、明确的输入/输出/验收方式。
4. 将经验拆分：一次性问题求解 / 可复用 SOP / 可执行资产候选。
5. 对每个候选做复用性判断（是否重复、触发语境、输入输出清晰度）。
6. 与现有 `devlab-*` 资产对照（新增 / 补充 / 桥接 / 重复 / 不沉淀）。
7. 判断资产类型 → 查阅对应 reference 获取详细规范。
8. 判断沉淀位置（项目级 vs 团队共享）。
9. 输出结论、最小规格草案和 evidence-backed candidate manifest 草案。

## 资产类型决策矩阵

| 信号 | 资产类型 | 详细规范 |
|------|---------|---------|
| 流程可文档化，步骤稳定 | **Skill** | [REFERENCE-ASSET-SKILL.md](references/REFERENCE-ASSET-SKILL.md) |
| 需要命令行工具封装 | **CLI** | [REFERENCE-ASSET-CLI.md](references/REFERENCE-ASSET-CLI.md) |
| 需要外部服务集成 | **MCP** | [REFERENCE-ASSET-MCP-SUBAGENT.md](references/REFERENCE-ASSET-MCP-SUBAGENT.md) |
| 需要周期性闭环或循环排障 | **Loop** | [REFERENCE-ASSET-LOOP.md](references/REFERENCE-ASSET-LOOP.md) |
| 需要独立 Agent 角色 | **Subagent** | [REFERENCE-ASSET-MCP-SUBAGENT.md](references/REFERENCE-ASSET-MCP-SUBAGENT.md) |
| 判断思路 / 经验 / 启发 | **知识卡片** | 不创建资产，记录到 Obsidian 知识库 |
| 特定库/框架的使用指南 | **Skill（`*-usage`）** | [REFERENCE-ASSET-SKILL.md](references/REFERENCE-ASSET-SKILL.md) |

**复盘决策深度参考**：[REFERENCE-DISTILLATION-RULES.md](references/REFERENCE-DISTILLATION-RULES.md)（R1-R5 规则 + A1-A4 反模式）

## 沉淀位置决策

```
输入输出是否稳定？
  否 → 项目级 (.claude/skills/)
  是 → 是否依赖私有上下文？
    是 → 项目级
    否 → 团队共享 (harness-ai-kit/skills/)
```

## 命名规范

遵循 `docs/namespace-conventions.md` 中 devlab 二级命名体系：

| 前缀 | 领域 | 示例 |
|------|------|------|
| `devlab-srv-*` | 后端 / 服务（API、业务逻辑、中间件集成） | `devlab-srv-spring-boot-sop` |
| `devlab-web-*` | 网站 / Web 应用（页面、组件、前端框架） | `devlab-web-react-sop` |
| `devlab-tool-*` | 开发工具（脚手架、代码生成、工程化脚本） | `devlab-tool-codegen-sop` |
| `devlab-cicd-*` | CI/CD 编排（构建、部署、流水线配置） | `devlab-cicd-onboard` |
| `devlab-*`（省略二级） | 不归属特定技术栈 | `devlab-srv-reliability-ops` |

**判定规则**：后端服务 → `srv`；网站/Web → `web`；开发工具 → `tool`；CI/CD → `cicd`；不归属 → 省略。

## 与 base-session-ai-kit-miner 的关系

| 维度 | base-session-ai-kit-miner | devlab-ai-kit-miner |
|------|----------------------|-------------------|
| 适用范围 | 通用任务复盘 | 研发场景专用（全栈） |
| 资产类型 | Skill / Loop / 知识卡片 | Skill / CLI / MCP / Loop / Subagent / 知识卡片 |
| Loop 提炼 | 内置 6 信号评分 + 字段映射 Rubric | 复用上游评分，增加研发 Loop 子类型判定 |
| 命名规范 | 无 | `devlab-srv/web/tool` 二级前缀 |
| 沉淀位置 | 不区分 | 项目级 vs 团队共享 |
| 工具链集成 | 无 | harness-ai-kit (skill.json, USAGE.md, CHANGELOG.md) |

**依赖链**：`devlab-ai-kit-miner` → `base-session-ai-kit-miner`（通用判断 + Loop 提炼）。

## 与 harness-ai-kit-forge 的接力

本技能负责**复盘提炼**阶段，输出脱敏证据和 candidate 草案，不直接修改正式 Skill。
`patch-existing` 交给 `harness-ai-kit-maintainer`，`create-new` 经用户确认后交给
`harness-ai-kit-forge`，`reject-local-only` 只保留项目级记录。

```
devlab-ai-kit-miner 复盘输出 evidence + candidate/v1 草案
        │
        ▼ (harness-ai-kit-evolution-ops 编排评测与 review)
patch-existing → harness-ai-kit-maintainer
create-new    → harness-ai-kit-forge
reject-local-only → 不进入共享资产
```

## 团队共享资产必要条件

1. `skill.json` / `cli.json` / `loop.json` 完整填写
2. `USAGE.md` 存在且包含"可直接复制的中文 Prompt"
3. `CHANGELOG.md` 记录版本历史
4. 不含私有路径、凭证、个人习惯
5. 输入输出可被其他团队成员理解
6. 来源脱敏：正文 / CHANGELOG / 元数据不得深度包含具体项目名、产品名、会话 ID、内部域名或路径；来源用匿名化表述（如"某上游产品二开项目（已脱敏）"），量化锚点可保留

## 约束

- 不要为了体系化而强行沉淀。证据不足时明确说"暂不建议"。
- 先检查 `harness-ai-kit/skills/` 和 `.claude/skills/` 是否已有可复用资产。
- 沉淀到团队仓库必须有对应的 metadata 文件 + `USAGE.md` + `CHANGELOG.md`。
- 涉及私有路径、凭证、个人习惯的内容不得进入团队共享。
- 涉及具体项目/产品的反哺内容必须先脱敏再沉淀：项目名、产品名、会话 ID、内部域名与路径一律匿名化（如"某上游产品二开项目（已脱敏）"），量化证据可保留。
- 不要只根据最后一轮消息做复盘；默认结合 session 连续历史。
- 不得把未脱敏 trace/session、凭据、内部路径或一次性项目偏好写入 candidate 或共享资产。
- candidate 开始评测后视为不可变；后续修订必须生成新的 candidate id。

## 专题引用

- [REFERENCE-DISTILLATION-RULES.md](references/REFERENCE-DISTILLATION-RULES.md)：沉淀决策规则与反模式（R1-R5, A1-A4）
- [REFERENCE-ASSET-SKILL.md](references/REFERENCE-ASSET-SKILL.md)：Skill 资产创建规范
- [REFERENCE-ASSET-CLI.md](references/REFERENCE-ASSET-CLI.md)：CLI 资产创建规范
- [REFERENCE-ASSET-LOOP.md](references/REFERENCE-ASSET-LOOP.md)：Loop 资产创建规范（含子类型）
- [REFERENCE-ASSET-MCP-SUBAGENT.md](references/REFERENCE-ASSET-MCP-SUBAGENT.md)：MCP / Subagent 资产创建规范
- [REFERENCE-REAL-WORLD-EXAMPLE.md](references/REFERENCE-REAL-WORLD-EXAMPLE.md)：真实案例复盘

## 推荐触发方式

```text
用 devlab-ai-kit-miner 复盘这次研发会话，判断有没有值得沉淀的内容。
```

```text
这轮开发做完了。用 devlab-ai-kit-miner 看看是该更新旧资产、做知识卡片，还是新建 devlab-* 资产。
```

## 推荐输出格式

```markdown
# 复盘结论

## 一、任务概况
## 二、候选沉淀点
## 三、资产类型判断
## 四、沉淀位置建议
## 五、候选资产最小规格
## 六、与现有 devlab-* 资产的关系
## 七、暂不沉淀的部分
```

## 八、与审查流水线的关系

本技能产出的沉淀候选建议作为草稿进入 Draft → Eval → Review → Merge 流水线（`historyminerctl push`），
由 [`harness-ai-kit-evolution-ops`](../harness-ai-kit-evolution-ops/SKILL.md) 编排
`evalctl candidate/skill-eval/diff`，再由 [`harness-ai-kit-review-ops`](../harness-ai-kit-review-ops/SKILL.md)
审查后交给 maintainer，不直提交。

## 参数化演进（pilot）

本 Skill 的行为参数 pilot 声明在
`evals/parameters/devlab-ai-kit-miner.parameters.yaml`：

- `evidence_threshold`：证据充分性阈值，允许在声明范围内调参。
- `duplicate_similarity_threshold`：与既有资产相似度判定阈值，允许在声明范围内调参。

参数优化只生成 `profile` candidate 和可审查的 trial 记录；不得修改本文件的安全边界、脱敏要求、人工审查点或生产配置。

## Human Decisions

> 结构化同源见 `decisions.yaml`；以下为人类可读汇总。

| # | 决策点 | 触发条件 | 选项 | 默认行为 |
|---|--------|---------|------|---------|
| HD-1 | 提炼资产是否推进创建/发布 | 复盘识别出可沉淀的 devlab-* 资产草案后 | 用户确认后推进创建/发布 / 仅记录不落地 | 必问 |

参考文档：
- references/REFERENCE-README.md