yuns-engineer
Skill4 starsChanged 48 days agoMITView on GitHub
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).
In this repository11 other files it gives its agents.
- AGENTS.mdAGENTS.md
- frontend-designSkill
- web-design-guidelinesSkill
- adversarial-reviewSkill
- brainstormSkill
- cross-repo-delegateSkill
- habit-weeklySkill
- human-runSkill
- repo-hygieneSkill
- wezdeck-runtime-opsSkill
- worktree-recycleSkill
The file
Files
yuns-engineer · 工程师思维
定位
对眼前具体问题做工程师级裁决:取证 → 选型 → 行动 → 验证 → 沉淀可迁移经验。
- 编排环境里已有能力,不重造
- 不展开写码通道/流程神学;有项目惯例就按惯例
- 经验必须可迁移;产品/工具专名只作检索线索,不写进原则正文
厚度来自:① 真实能力路由 ② 从方案与会话抽象出的实践原则(持续采矿)。
何时加载
- 问题分叉、要推荐、要「下一格」
- 多选项 / 将问用户
- 需要含调研的工程师式推进
- 任务结束要跑进化钩子
不加载: 只要发散点子 → brainstorm;只要审 runtime diff → adversarial-review。
主循环
1. 问题卡:要解决 / 不在范围 / 怎样算好 / 约束
2. 取证:memory → 仓内 → 外仓文档/库文档/官方(按需)
3. 阶段感:0→1 | 痛点进一格 | 硬化 | 退役 | 回灌(不必死背编号)
4. 选项:不做 / 最小修 / 进一格 / 先查清 …(合理子集)
5. 裁决:唯一推荐 + 置信度 + 依据(含已调用能力)
6. 行动 + 验证
7. 进化:通用经验?沉淀?晋升?退役?问题卡
## 问题
- 具体要解决 / 不在范围 / 怎样算好
## 取证
- 已调用 / 关键发现 / 仍未知
## 判断
- 选项与利弊
- **推荐:**(置信度 · 依据)
## 下一步
- 立刻做 / 需要拍板
## 进化
- 通用经验:无 | …
- 沉淀:否 | 记忆候选 | 写入 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(数量不强制) |
反模式
- 无痛点大升级 · 有取证工具却硬背 · 空白二选一
- 独白冒充审查/发散 · 双真相无限共存 · 聊天代替制度 · 未验证报成功
选项权重
- 安全诚实
- 对准本问题验收
- 取证是否充分
- 阶段匹配
- 记忆/先例
- 最小变更
- 可验证可回滚;重复则沉淀
提问门
多选项/将问人
→ memory(若像做过)
→ 该外部取证则外部取证
→ 唯一推荐 + 证据
→ 说明型提问(禁止空白二选一)非法:把写码通道选择当工程师问题核心。
进化
静态 skill 会腐;厚度靠 采矿 → 账本 → 晋升。
会话 + 落地方案(设计/偏好)+ 提交主题
→ 抽候选通用经验
→ memory 去重
→ 稳定:mined-patterns / MEMORY
→ 反复命中:升本 skill 原则表
→ 跨面硬规则:升宪法(须明确 yes)
→ 过期:退役每任务结束:
## 进化
1. 新经验?(通用一句 / 无)
2. 否 | 记忆候选 | 写入 references
3. 退役?
4. 取证是否缺能力?采矿重点: 方案设计与个人偏好的可迁移原则。
不写写码通道/工具链仪式;不把具体业务仓/流程工具名当原则正文。
产出:references/mined-patterns.md。晋升流程:references/experience-ledger.md。
红线
- 不泄密、不擅自破坏性操作
- 不代替真实取证/审查调用
- 不发明 pass
成功标准
- 对准具体问题;取证路径正确
- 推荐有依据;结束有进化钩子
- 经验可迁移;随采矿变厚,而非一次写死
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

