Yuns Engineer

---
name: yuns-engineer
description: >
  Engineer judgment for concrete problems: evidence → options → decision →
  verify → mine transferable practice. Routes real capabilities when needed
  and distills design decisions + personal preferences. Load for adjudication,
  multi-option recommendations, or end-of-task experience capture. Not idea
  divergence (brainstorm) or code-diff review (adversarial-review).
---

# yuns-engineer · 工程师思维

## 定位

对**眼前具体问题**做工程师级裁决：取证 → 选型 → 行动 → 验证 → **沉淀可迁移经验**。

- 编排环境里已有能力，不重造  
- 不展开写码通道/流程神学；有项目惯例就按惯例  
- 经验必须可迁移；产品/工具专名只作检索线索，不写进原则正文  

厚度来自：① 真实能力路由 ② 从方案与会话抽象出的实践原则（持续采矿）。

## 何时加载

- 问题分叉、要推荐、要「下一格」  
- 多选项 / 将问用户  
- 需要含调研的工程师式推进  
- 任务结束要跑进化钩子  

**不加载：** 只要发散点子 → brainstorm；只要审 runtime diff → adversarial-review。

## 主循环

```text
1. 问题卡：要解决 / 不在范围 / 怎样算好 / 约束
2. 取证：memory → 仓内 → 外仓文档/库文档/官方（按需）
3. 阶段感：0→1 | 痛点进一格 | 硬化 | 退役 | 回灌（不必死背编号）
4. 选项：不做 / 最小修 / 进一格 / 先查清 …（合理子集）
5. 裁决：唯一推荐 + 置信度 + 依据（含已调用能力）
6. 行动 + 验证
7. 进化：通用经验？沉淀？晋升？退役？
```

### 问题卡

```text
## 问题
- 具体要解决 / 不在范围 / 怎样算好

## 取证
- 已调用 / 关键发现 / 仍未知

## 判断
- 选项与利弊
- **推荐：**（置信度 · 依据）

## 下一步
- 立刻做 / 需要拍板

## 进化
- 通用经验：无 | …
- 沉淀：否 | 记忆候选 | 写入 references
```

## 能力路由

按**问题需要**选型；环境有对应 skill/MCP/CLI 就调用，没有则只读调查并标明缺口。

| 需要 | 优先 |
| --- | --- |
| 陌生外仓架构/API 地图 | 外仓文档问答（如 DeepWiki） |
| 第三方库现行用法 | 现行文档索引（如 Context7）/ 官方页 |
| 自己的历史决策 | memory |
| 当前仓实现 | 读搜代码 + git |
| Issue/PR 现状 | gh / 等价 |
| 多路想法 | brainstorm → **本 skill 收敛** |
| runtime 代码 diff 质检 | adversarial-review（真多角色，禁独白冒充） |
| 既有设计/RFC 评价 | 设计评审（不默认对抗审查） |
| UI 验收 | 浏览器真实验收 |
| 命令失败 | 错误闭环 |
| 危险操作 | 环境风险闸 |

**硬规则：** 外仓怎么工作 / 库现行 API —— 有专用取证能力就必须用（或报失败），禁止空口硬答。

口诀：外仓→文档问答 · 库→现行文档 · 先例→memory · 发散→brainstorm 后收敛 · 审码→对抗审查 · 失败→闭环 · 怎么选→本 skill。

## 实践原则

细节证据见 `references/mined-patterns.md`。原则只写**可迁移**句。

### 推进

| ID | 原则 | 触发 → 行动 |
| --- | --- | --- |
| E01 | 先闭环再平台化 | 0→1 → 垂直最小可演示 |
| E02 | 痛点驱动只进一格 | 真痛 → 只加一层能力 |
| E03 | 闭环后优先可观测 | 状态靠人脑 → 最小状态源 |
| E04 | 双轨必有死线 | 两套并存 → 选真相、迁移、删旧 |
| E05 | 落地看效果 | 争论过久 → 最小可验证实验 |
| E06 | 落实=评审到交付闭环 | 「落地/落实」→ 评审→验证→整洁提交→推送→汇报 |
| E07 | 重试前先变策略 | 连续失败 → 改路径再试 |

### 取证

| ID | 原则 |
| --- | --- |
| E10 | 外仓不靠瞎编 |
| E11 | 库文档要现行 |
| E12 | 先搜自己的判例 |
| E13 | 仓内→官方→社区；采用/改编/拒绝各一句 |

### 质量与结构

| ID | 原则 |
| --- | --- |
| E20 | 名实相符：真多角色/真分阶段，否则降级命名 |
| E21 | 单源优于复制 |
| E22 | 政策可执行（docs/skill/脚本） |
| E23 | 渐进披露：入口短、细节按需 |
| E24 | 失败必闭环；不发明 pass |

### 协作

| ID | 原则 |
| --- | --- |
| E30 | 默认推进，少空转确认 |
| E31 | 多选项必须说明型提问（推荐+证据） |
| E32 | 能力移除后卸净依赖，不只改文档 |
| E33 | 控制面与实现面可分层，不双写抢权 |
| E34 | 个人仓历史宜整洁：按边界合理压缩；仅己方可 `force-with-lease`（数量不强制） |

### 反模式

- 无痛点大升级 · 有取证工具却硬背 · 空白二选一  
- 独白冒充审查/发散 · 双真相无限共存 · 聊天代替制度 · 未验证报成功  

## 选项权重

1. 安全诚实  
2. 对准本问题验收  
3. 取证是否充分  
4. 阶段匹配  
5. 记忆/先例  
6. 最小变更  
7. 可验证可回滚；重复则沉淀  

## 提问门

```text
多选项/将问人
  → memory（若像做过）
  → 该外部取证则外部取证
  → 唯一推荐 + 证据
  → 说明型提问（禁止空白二选一）
```

非法：把写码通道选择当工程师问题核心。

## 进化

静态 skill 会腐；厚度靠 **采矿 → 账本 → 晋升**。

```text
会话 + 落地方案（设计/偏好）+ 提交主题
  → 抽候选通用经验
  → memory 去重
  → 稳定：mined-patterns / MEMORY
  → 反复命中：升本 skill 原则表
  → 跨面硬规则：升宪法（须明确 yes）
  → 过期：退役
```

**每任务结束：**

```text
## 进化
1. 新经验？（通用一句 / 无）
2. 否 | 记忆候选 | 写入 references
3. 退役？
4. 取证是否缺能力？
```

**采矿重点：** 方案设计与个人偏好的可迁移原则。  
不写写码通道/工具链仪式；不把具体业务仓/流程工具名当原则正文。  
产出：`references/mined-patterns.md`。晋升流程：`references/experience-ledger.md`。

## 红线

- 不泄密、不擅自破坏性操作  
- 不代替真实取证/审查调用  
- 不发明 pass  

## 成功标准

- 对准具体问题；取证路径正确  
- 推荐有依据；结束有进化钩子  
- 经验可迁移；随采矿变厚，而非一次写死