From team-skills-platform
统一进化资产模型与自进化闭环核心。定义 Gene(策略 DNA)、Capsule(已验证经验快照)、 EvolutionEvent(追加式事件日志)三层资产模型,实现 Detect→Select→Replay→Validate→Solidify→Reuse 闭环,使 agent 遇到已知问题时先复用已验证经验,跳过重新试错。
npx claudepluginhub colin4k1024/tspThis skill uses the workspace's default tool permissions.
- **即时复用**:agent 遇到错误时,先从进化存储中查找匹配的已验证经验(Capsule),尝试重放,成功则跳过 LLM 推理
Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.
Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.
Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.
Gene 是一条可复用的问题解决策略,从一次或多次成功经验中提取并泛化:
{
"gene_id": "g-a1b2c3d4",
"signals": [
{
"signal_type": "compiler_error",
"source": "compiler",
"pattern": "Cannot find module '(.+)'",
"context_hints": ["typescript", "import"]
}
],
"strategy": {
"description": "检查 tsconfig.json paths 配置和 package.json dependencies,确认模块存在后重新安装",
"steps": [
"检查 tsconfig.json 中 paths 和 baseUrl 配置",
"检查 package.json 中是否包含该依赖",
"运行 npm install 或对应包管理器安装命令",
"若为路径别名问题,更新 tsconfig paths"
],
"constraints": ["不要直接删除 node_modules 重装,先定位根因"]
},
"validation_rules": {
"success_indicator": "tsc 编译通过,无 Cannot find module 错误",
"timeout_seconds": 120
},
"confidence": 0.75,
"state": "promoted",
"tags": ["typescript", "module-resolution", "build-error"],
"env_fingerprint": {
"languages": ["typescript"],
"frameworks": ["next.js"],
"tools": ["npm"]
},
"stats": {
"total_uses": 12,
"successes": 10,
"failures": 2,
"last_used": "2026-04-01T10:30:00Z"
},
"created_at": "2026-03-15T08:00:00Z",
"updated_at": "2026-04-01T10:30:00Z"
}
Gene 状态生命周期:
candidate → promoted → archived
↓ ↓
revoked quarantined → (re-promoted | revoked)
| 状态 | 含义 |
|---|---|
candidate | 新提取,尚未达到晋升门槛 |
promoted | 经过多次验证,高置信度可用 |
quarantined | 从外部导入或连续失败,需本地验证 |
revoked | 多次失败或人工标记无效 |
archived | 长期未使用,自动归档 |
Capsule 是 Gene 的一次具体执行记录,包含完整的上下文和结果:
{
"capsule_id": "c-e5f6g7h8",
"gene_ref": "g-a1b2c3d4",
"execution_context": {
"project_id": "proj-xyz",
"agent_id": "agent-session-001",
"trigger_signal": {
"signal_type": "compiler_error",
"source": "compiler",
"raw_message": "Cannot find module '@/utils/helpers'",
"file_path": "src/pages/index.tsx"
}
},
"outcome": {
"success": true,
"changes_summary": "更新 tsconfig.json paths 配置,添加 @/ → src/ 映射",
"diff_hash": "sha256:abc123...",
"files_changed": ["tsconfig.json"],
"lines_modified": 3,
"duration_seconds": 15
},
"env_fingerprint": {
"os": "darwin",
"node_version": "20.x",
"typescript_version": "5.4",
"package_manager": "npm"
},
"confidence": 0.85,
"created_at": "2026-04-01T10:30:00Z"
}
EvolutionEvent 是不可变的事件记录,构成进化存储的唯一事实源(single source of truth):
{
"event_id": "ev-20260401-001",
"type": "capsule_reused",
"timestamp": "2026-04-01T10:30:00Z",
"agent_id": "agent-session-001",
"payload": {
"gene_id": "g-a1b2c3d4",
"capsule_id": "c-e5f6g7h8",
"success": true,
"confidence_delta": 0.05
}
}
事件类型:
| 类型 | 触发时机 |
|---|---|
signal_detected | 检测到错误/问题信号 |
gene_created | 新 Gene 从成功经验中提取 |
gene_updated | Gene 置信度、统计或状态更新 |
gene_promoted | Gene 从 candidate 晋升为 promoted |
gene_revoked | Gene 被标记为无效 |
gene_quarantined | Gene 进入隔离区 |
capsule_created | 新的执行快照产生 |
capsule_reused | 已有 Capsule 被重放使用 |
replay_attempted | 尝试重放但未成功 |
governor_blocked | Governor 阻止了某个操作 |
network_published | Gene/Capsule 发布到共享网络 |
network_fetched | 从共享网络获取了资产 |
┌──────────────────────────────────────────────────────┐
│ Evolution Loop │
│ │
│ ① Detect ──→ ② Select ──→ ③ Replay │
│ │ │ │ │
│ │ │ ├─ 成功 → ⑥ Reuse │
│ │ │ │ │
│ │ │ └─ 失败 ↓ │
│ │ │ │
│ │ └──→ ④ Execute (LLM) │
│ │ │ │
│ │ ↓ │
│ │ ⑤ Validate │
│ │ │ │
│ │ ├─ 通过 → Solidify → Gene+ │
│ │ │ Capsule │
│ │ └─ 失败 → 记录失败事件 │
│ │ │
│ └─── Governor 全程监控速率/半径/回归 ──────────────│
└──────────────────────────────────────────────────────┘
~/.claude/evolution/
├── events.jsonl # 追加式事件日志(唯一事实源)
├── genes.json # Gene 投影缓存(从 events 重建)
├── capsules.json # Capsule 投影缓存(从 events 重建)
├── LOCK # 并发写入保护
├── config.json # 本地配置(Governor 参数等)
└── shared/ # 跨 agent 共享区
├── published/ # 本地发布的资产
└── quarantine/ # 外部导入的待验证资产
| 来源 | 初始值 |
|---|---|
| 首次成功解决 | 0.40 |
| 从 error-experience 迁移 | 根据 success_rate 映射 |
| 从 instinct 迁移 | 保留原有 confidence |
| 从外部网络导入 | 0.30(进入 quarantine) |
成功复用: confidence = min(0.95, confidence + 0.05)
失败复用: confidence = max(0.10, confidence - 0.10)
时间衰减: confidence = confidence × e^(-0.001 × days_since_last_use)
手动标记: confidence = 指定值
| 转换 | 条件 |
|---|---|
| candidate → promoted | confidence ≥ 0.60 且 successes ≥ 3 |
| promoted → quarantined | 连续失败 ≥ 3 次 |
| quarantined → promoted | 本地验证通过 2 次以上 |
| * → revoked | confidence < 0.15 或手动标记 |
| promoted → archived | 90 天未使用 |
信号匹配分三级:
最终匹配分 = match_score × gene_confidence × env_similarity
| 命令 | 用途 |
|---|---|
/replay <error> | 手动查询匹配的 Gene 并尝试重放 |
/evolution-status | 查看进化存储状态面板 |
/evolve | 将 instinct 聚类为 Gene(升级版) |
/instinct-export | 导出进化资产(升级版) |
/instinct-import | 导入进化资产(升级版) |
| 现有系统 | 关系 |
|---|---|
| error-experience-library | Gene 的数据来源之一;迁移后 /error-lookup 仍可用,底层查询 Evolution Store |
| continuous-learning | Instinct 可晋升为 Gene;观察流程继续保留 |
| instinct-export/import | 升级为 Evolution Asset 导入导出 |
| session-end hook | 增加 solidify 调用,自动从 git diff 提取 Gene |
| session-start hook | 增加进化上下文注入 |
scripts/evolution/store.py — Evolution Store 读写接口scripts/evolution/replay.py — Replay-First 执行器scripts/evolution/governor.py — Governor 治理层scripts/evolution/network.py — 跨 agent 共享网络scripts/evolution/migrate.py — 从旧系统迁移数据