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
需要命令行工具封装	CLI	REFERENCE-ASSET-CLI.md
需要外部服务集成	MCP	REFERENCE-ASSET-MCP-SUBAGENT.md
需要周期性闭环或循环排障	Loop	REFERENCE-ASSET-LOOP.md
需要独立 Agent 角色	Subagent	REFERENCE-ASSET-MCP-SUBAGENT.md
判断思路 / 经验 / 启发	知识卡片	不创建资产，记录到 Obsidian 知识库
特定库/框架的使用指南	Skill（*-usage）	REFERENCE-ASSET-SKILL.md

复盘决策深度参考：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：沉淀决策规则与反模式（R1-R5, A1-A4）
• REFERENCE-ASSET-SKILL.md：Skill 资产创建规范
• REFERENCE-ASSET-CLI.md：CLI 资产创建规范
• REFERENCE-ASSET-LOOP.md：Loop 资产创建规范（含子类型）
• REFERENCE-ASSET-MCP-SUBAGENT.md：MCP / Subagent 资产创建规范
• REFERENCE-REAL-WORLD-EXAMPLE.md：真实案例复盘

推荐触发方式

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

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

推荐输出格式

# 复盘结论

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

八、与审查流水线的关系

本技能产出的沉淀候选建议作为草稿进入 Draft → Eval → Review → Merge 流水线（historyminerctl push）， 由 harness-ai-kit-evolution-ops 编排 evalctl candidate/skill-eval/diff，再由 harness-ai-kit-review-ops 审查后交给 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