Real Engineering Skills

面向编码 Agent 的具体工作流技能，每一条都来自真实工作中反复出现的任务。

English

本仓库是 real-engineering-prompt 的姊妹项目。prompt 仓维护的是跨仓库改进 Agent 输出的最小行为层；有些工作太具体，不适合放进 prompt——多步流程、独立的文件布局、路径约定与验证步骤。这些属于 skill：只在任务用到时才加载。

Skills 一览

Skill	用途
lesson-learn	把刚解决的踩坑（环境/网络/证书/部署/工具/配置）固化成可复用的 runbook，写入当前 harness 的全局 lesson/ 目录，并索引到该 harness 的全局指令文件（AGENTS.md，Claude Code 为 CLAUDE.md）。全自动：标题与摘要由 Agent 从会话中自行提炼，不向用户索要任何字段。适配 pi / codex / zcode / Claude Code 多种 harness。

安装

ZCode 等 Agent 从 ~/.agents/skills/<name>/SKILL.md（用户级）和 <project>/.agents/skills/<name>/SKILL.md（项目级）发现技能；Claude Code 从 ~/.claude/skills/<name>/SKILL.md（用户级）和 <project>/.claude/skills/<name>/SKILL.md（项目级）发现技能。

把仓库克隆到任意位置，再链接到所用 harness 的技能目录即可：

git clone https://github.com/GonChen/real-engineering-skills.git
ln -s /path/to/real-engineering-skills/skills/lesson-learn ~/.agents/skills/lesson-learn   # pi, codex, zcode 等
ln -s /path/to/real-engineering-skills/skills/lesson-learn ~/.claude/skills/lesson-learn   # claude code

软链接让克隆仓可编辑、技能即时生效；直接拷贝技能目录也可以。

设计原则

一个技能只做一件事

技能沉淀的是真实会话中反复出现的流程，不是模型已有的通用知识。模型凭上下文就能可靠完成的事，不做成技能。

写清触发条件，不写人设

每个技能定义何时适用——用户措辞、任务形态——以及产出什么。只规定动作和可验证的结果，不扮演任何角色。

沉淀流程，不复述知识

技能默认 Agent 本身有能力。它补充的是文件布局、路径约定、步骤顺序与验证方式，不复述语言、框架或标准实践。

正文保持精简

元数据常驻上下文，正文只在触发时加载。技能保持简短；过长的内容拆成按需读取的 reference 文件。

贡献

保持提案精简。说明反复出现的任务是什么、为什么 Agent 凭上下文无法可靠完成、技能的步骤如何被遵循和验证。通用建议和知识搬运不在范围内。

许可

MIT

如果你觉得这些技能还不错——哪怕只有一点点用——欢迎给仓库点个 Star，多谢 🙏