> Harness EngineeringHarness EngineeringHarness Engineering The engineering outside the model模型之外的工程模型之外的工程

7.1

People and teams: what stays with a person人與團隊:留給人的事人与团队:留给人的事

This chapter assumes you have read Instructions and skills. The rules, their owners and their review are in Roll out and govern a harness.

讀這一章,你需要讀過 指令與 skill:只載入需要的。規則、規則的負責人和審查,在 落地與治理。

读这一章之前,需要先读过指令与 skill:只加载需要的。规则、规则的负责人和审查,放在落地与治理里讲。

The Knowledge經驗分享经验分享

In one sentence

With an agent doing more, a person's work moves up to four judgments: what to do, what is allowed, where to say yes, and whether the result is good. A new teammate needs one habit and one real task, not the full tour.

一句話

agent 做得越多,人的工作就上移成四個判斷:做什麼、允許什麼、在哪裡說好、結果好不好。新同事需要的是一個習慣和一個真實的任務,不是整套導覽。

一句话

agent 做得越多,人的工作就越往上移,剩下四个判断:做什么、什么被允许、在哪里点头、结果好不好。新同事需要的是一个习惯和一个真实的任务,不是把整套东西走一遍。

For leaders

  • The decision: decide who in the team makes each of the four judgments, and decide that a newcomer starts with one habit and one real task.
  • The risk: I have no numbers. The risk I can name is this: if the first hour is the full tour, a newcomer decides the setup is heavy and goes back to what they did before. And a setup that holds only if every person reads the rules is weaker than one that refuses the dangerous thing by itself.
  • The cost of doing it right: a first hour per newcomer, plus the time to pick one small task from the team's own work.
  • Ask the team: "Who decides what is allowed, where a person must say yes, and whether the result is good, and what does a new person do in their first hour?"

給主管

  • 要做的決定:決定團隊裡誰來做這四個判斷各自的那一個,並決定新人從一個習慣和一個真實的任務開始。
  • 風險:我沒有數字。我能說出名字的風險是:如果第一個小時是完整導覽,新人會認定這套設定很重,然後回到原本的做法。而且,一套要每個人都讀了規則才成立的設定,比一套自己拒絕危險事情的設定弱。
  • 做對的成本:每個新人一個小時,加上從團隊自己的工作裡挑一個小任務的時間。
  • 可以問團隊:「誰決定什麼是允許的、哪裡必須有人說好、結果好不好?新人的第一個小時做什麼?」

写给管理者

  • 要拍板的事:定下团队里谁来做这四个判断,并定下新人从一个习惯和一个真实任务开始。
  • 风险:我没有数据。我能说出的风险是:第一个小时就把整套东西走一遍,新人会觉得这套配置很重,转头回到老办法。另外,要靠每个人都读规则才成立的配置,比自己拒绝危险操作的配置更弱。
  • 做对的代价:每个新人一个小时的上手时间,外加从团队自己的工作里挑一个小任务的时间。
  • 可以问团队:“谁来决定什么被允许、哪里必须有人点头、结果好不好?新人的第一个小时做什么?”

The problem

When one person uses an agent, the person does all four jobs without noticing. They know what they want, they know what the agent may touch, they decide when to stop and look, and they judge the result. Hand the setup to a team and these jobs have to be assigned, or nobody does them.

There is a second problem, and it is about people, not rules. Some colleagues will not read anything. They did not ask for an agent. If their first hour is a lecture, they go back to what they did before.

I should be honest about my own position. I built my setup for one person and I have not run a team rollout with measurements. What follows is a design built from what the setup already does and from my own use. Where something is only a proposal, I say so.

問題

一個人用 agent 的時候,這四件事都是這個人在做,自己沒注意到。他知道自己要什麼,知道 agent 可以碰什麼,決定什麼時候停下來看,並判斷結果。把設定交給一個團隊,這些工作就得分配出去,不然沒人做。

還有第二個問題,它是關於人,不是關於規則。有些同事什麼都不會讀。他們沒有要求要一個 agent。如果他們的第一個小時是一場演講,他們會回到原本的做法。

我該誠實說明自己的位置。我的設定是為一個人建的,我沒有帶著測量,做過團隊落地。下面是一個設計,根據設定已經在做的事,和我自己的使用建成的。只是提議的地方,我會說。

问题

一个人用 agent 的时候,四件事他一个人全做了,自己都没注意。他知道自己要什么,知道 agent 可以动什么,决定什么时候停下来看一眼,也判断结果好不好。把这套配置交给一个团队,这几件事就得分派下去,否则没人做。

还有第二个问题,它和人有关,和规则无关。有些同事什么都不会读。他们没要求过用 agent。如果第一个小时是一场讲座,他们就回到原来的做法了。

我要说清楚自己的位置。我的配置是为一个人搭的,我没有带着测量去做过团队落地。下面讲的,是根据这套配置现在能做的事和我自己的使用经验设计出来的。只是建议的地方,我会说明。

How it works

What stays with a person

First, what the people are for. The more the agent does, the more a person's work moves up, away from typing and toward four judgments the agent cannot make for you.

the agent does more of the person keeps reading and searching code writing the changes running the steps fixing what its own checks find what to do what is allowed (the rules) where to say yes whether the result is good
The more the agent does, the more the person's work moves up to four judgments.
  1. What to do. A request is vague and it shifts. A person confirms the one page that says what "done" means (The agent writes the requirement, the person confirms it).
  2. What is allowed. The rules, and who may pass them. Who owns them and who reviews a change is the subject of Roll out and govern a harness.
  3. Where to say yes. The points that cost money, grant power or cannot be undone (Two gates: where a person approves).
  4. Whether the result is good. An agent's report can be wrong. A person, or a check the person trusts, decides (Can a model check a model?).

A team needs all four, and the second is the one that no tool will do for you.

Getting a new person started

The failure to avoid is the full tour. Two gates (Two gates: where a person approves), a board (Ten things at once: parallel tasks), a knowledge base and reports on the first day tell a newcomer that this is heavy (A minimal harness in 30 minutes). A better first hour has three parts.

  1. A guided setup that checks itself. A skill walks them through the steps one by one (the install, their name and language, the repositories, the knowledge base) and runs a check after each. The newcomer is never left wondering whether it worked.
  2. One small real task, from the team's own work. In my setup the first lesson ends in a practice task, and its scenario is a file that a team can replace with its own. Practice on the code they will really touch, not on a toy.
  3. A way to ask why. A newcomer who can ask the harness to explain itself, with the real files open, needs no one to sit beside them.

The colleague who does not care

For the colleague who does not care, I would ask for one habit, not a mindset: say what you want done and open a task for it. The rest is carried by the setup. Dangerous commands are refused whether or not the person has read a rule, and a write needs approval whether or not they remember why. A harness that depends on every person reading the rules is a worse harness. I have not measured how this lands with a team that did not choose it.

What to learn, and what to skip

How much should people study? Learn the problems that stay the same: whom to trust, how to know it is right, what the agent should know, how to split work, what it costs. Skip what changes monthly: the setting names of one tool, the details of each new plugin system, which model is best this week. An hour on what a new thing is, and which old problem it answers, is enough. Look up the exact format when you need it.

原理

留給人的事

先講人是做什麼用的。agent 做得越多,人的工作就越往上移,離開打字,走向四個 agent 沒辦法替你做的判斷。

agent 做得更多的事 人留下的事 讀、搜尋程式碼 寫修改 跑各個步驟 修自己的檢查找到的問題 要做什麼 什麼被允許(規則) 在哪裡說「好」 結果好不好
agent 做得越多,人的工作就越往上移,剩下這四個判斷。
  1. 做什麼。要求是模糊的,而且會飄。由人確認那一頁說明「做完」是什麼意思(需求由 agent 寫,人確認)。
  2. 允許什麼。規則,和誰可以通過它們。誰擁有它們、誰審查改動,是 落地與治理 的主題。
  3. 在哪裡說好。花錢、授權或無法復原的那些點(兩道門:人在哪裡批准)。
  4. 結果好不好。agent 的報告可能是錯的。由人,或由人信任的檢查來決定(模型能檢查模型嗎)。

團隊四個都需要,而第二個,是沒有任何工具會替你做的。

讓新人開始

要避免的失敗是完整導覽。第一天就給兩道門(兩道門:人在哪裡批准)、一個看板(同時管十件事:並行的是任務)、一個知識庫和報告,等於告訴新人這很重(30 分鐘搭一個最小 harness)。比較好的第一個小時有三部分。

  1. 會自己檢查的引導式設定。一個 skill 帶他們一步一步走(安裝、他們的名字和語言、倉庫、知識庫),每一步之後執行一次檢查。新人不會一直懷疑到底有沒有成功。
  2. 一個小的真實任務,來自團隊自己的工作。在我的設定裡,第一堂課以一個練習任務結束,它的情境是一個檔案,團隊可以換成自己的。在他們真的會碰的程式碼上練習,不要在玩具上。
  3. 問為什麼的辦法。新人如果能請 harness 一邊打開真實的檔案,一邊解釋自己,就不需要有人坐在旁邊。

不在乎的同事

對不在乎的同事,我會要求一個習慣,不是一種心態:說出你要做什麼,並為它開一個任務。其餘由設定來承擔。危險的指令會被拒絕,不管這個人有沒有讀過規則;寫入需要批准,不管他記不記得為什麼。一個靠每個人都讀規則才行的 harness,是比較差的 harness。對一個沒有選擇它的團隊,這樣做的效果如何,我沒有量過。

要學什麼,要跳過什麼

大家該花多少心力學?學那些不變的問題:該信誰、怎麼知道是對的、agent 該知道什麼、怎麼拆工作、要花多少。跳過每個月都在變的:某一個工具的設定名稱、每個新外掛系統的細節、這週哪個模型最好。花一個小時,了解一個新東西是什麼、它回答哪一個舊問題,就夠了。需要確切的格式時再去查。

原理

留给人的事

先说人是干什么的。agent 做得越多,人的工作就越往上移,离开敲键盘,转向四个 agent 没法替你做的判断。

agent 做得更多的事 人留下的事 读、搜索代码 写改动 跑各个步骤 修自己的检查找到的问题 要做什么 什么被允许(规则) 在哪里点头 结果好不好
agent 做得越多,人的工作就越往上移,剩下这四个判断。
  1. 做什么。需求是含糊的,还会变。由人确认那一页说明“做完”是什么意思的文档(需求由 agent 写,人确认)。
  2. 什么被允许。规则,以及谁可以让某件事通过。谁负责规则、谁审查改动,是落地与治理的主题。
  3. 在哪里点头。花钱的、授予权力的、做了就撤不回的地方(两道门:人在哪里审批)。
  4. 结果好不好。agent 的报告可能是错的。要由人来判断,或者由人信得过的检查来判断(模型能检查模型吗)。

团队四个都需要,而第二个是任何工具都不会替你做的。

让新人上手

要避开的失败是把整套东西走一遍。两道门(两道门:人在哪里审批)、看板(同时管十件事:并行的是任务)、知识库和报告,第一天就全摆出来,等于告诉新人这套东西很重(30 分钟搭一个最小 harness)。更好的第一个小时有三部分。

  1. 带引导的、自己会检查的配置。一个 skill 带着他们一步一步走(安装、名字和语言、仓库、知识库),每一步后面都跑一次检查。新人不用猜“成功了没有”。
  2. 一个来自团队自己工作的小而真实的任务。在我的配置里,第一课以一个练习任务收尾,它的场景是一个文件,团队可以换成自己的。在他们真会动的代码上练,别用玩具。
  3. 有地方问“为什么”。新人能让 harness 打开真实的文件,给自己讲清楚它是怎么回事,就不需要有人坐在旁边。

不在乎的那位同事

对不在乎的同事,我只要求一个习惯,不要求一种心态:说出你要做什么,然后为它开一个任务。其余的由配置来扛。不管这个人读没读过规则,危险命令都会被拒绝;不管他还记不记得为什么,写入都需要审批。要靠每个人都读规则才成立的 harness,是更差的 harness。对一个不是自己选择的团队,这套做法效果如何,我没有测过。

学什么,跳过什么

人该学多少?学那些不变的问题:该信任谁,怎么知道结果对不对,agent 该知道什么,怎么拆分工作,要花多少钱。跳过每个月都在变的东西:某个工具的设置名,每个新插件系统的细节,这周哪个模型最好。花一个小时弄清一个新东西是什么、它回答的是哪个老问题,就够了。具体格式等用到时再查。

Costs and traps

A guided first hour needs maintenance. The practice task and the checks go stale when the code changes. Someone has to own them.

A small real task can still be the wrong one. Pick one that is real but forgiving: a mistake should cost the newcomer a retry, not a bad day.

One habit is not enough forever. It gets the person started. Over time they will meet the gates and the reports, and the first hour should not hide them.

I have no team data. The first hour and the one habit are a design built on one person's use. I have not measured how newcomers take to them. Treat them as a starting point to check, not as results.

代價和陷阱

引導式的第一個小時需要維護。程式碼一變,練習任務和檢查就過期。得有人負責。

小的真實任務,仍然可能是錯的那一個。挑一個真實、但容得下錯的:犯錯應該只讓新人重試一次,不是毀掉一天。

一個習慣不會永遠夠用。它讓人開始。時間久了,他們會遇到門和報告,第一個小時不該把它們藏起來。

我沒有團隊的資料。第一個小時和那一個習慣,是根據一個人的使用建成的設計。新人怎麼接受它們,我沒有量過。把它們當成要檢查的起點,不要當成結果。

代价和坑

带引导的第一个小时需要维护。练习任务和检查会随着代码的变化而过期。得有人负责它们。

小而真实的任务也可能选错。选真实但容错的:做错了,新人付出的代价是重试一次,不是糟糕的一天。

一个习惯不能管一辈子。它只是让人开始。时间一长,他们会遇到关卡和报告,第一个小时不该把这些藏起来。

我没有团队的数据。第一个小时和那一个习惯,是根据一个人的使用设计出来的。新人接不接受,我没有测过。把它们当作要验证的起点,不要当结果。

When to delete it

The guided setup exists because installing and configuring the harness takes many steps. If the setup shrinks to one command, or the platform does it, the guide can go. The four judgments do not go. They are what remains for a person however much the agent does.

什麼時候可以刪掉

引導式設定存在,是因為安裝和設定 harness 要很多步。如果設定縮成一個指令,或由平台來做,引導就可以拿掉。四個判斷不會拿掉。不管 agent 做多少,它們都是留給人的。

什么时候可以删掉

带引导的配置之所以存在,是因为安装和配置 harness 要很多步。如果配置缩成一条命令,或者平台替你做了,这个引导就可以删。四个判断不会消失。不管 agent 做多少,它们都是留给人的。

Try it on your own setup

No harness needed. Open your agent in your own repository and paste:

Pretend you are a new teammate who has never used an AI agent here. Read this repository's README and its agent instruction files, and write down your first hour: what you would have to install, read and learn before you could finish one small real task. Then, for each of these four judgments (what to do, what is allowed, where a person must say yes, whether the result is good), say where in this repository it is written down, or that it is not. Mark anything that would make a newcomer think the setup is heavy. Do not change any files.

在你自己的環境試試

不用裝 harness。在你自己的倉庫裡打開 agent,貼上:

假裝你是一個新同事,從來沒在這裡用過 AI agent。讀這個倉庫的 README 和它的 agent 指令檔,寫下你的第一個小時:在你能完成一個小的真實任務之前,你得安裝、閱讀和學習什麼。然後,對這四個判斷(做什麼、允許什麼、哪裡必須有人說好、結果好不好)中的每一個,說明它寫在這個倉庫的哪裡,或說明沒有寫。標出任何會讓新人覺得這套設定很重的東西。不要改任何檔案。

在你自己的环境里试试

不用装 harness。在你自己的仓库里打开 agent,粘贴:

假设你是一个从没在这里用过 AI agent 的新同事。读这个仓库的 README 和它的 agent 指令文件,写下你的第一个小时:在能完成一个真实的小任务之前,你得安装什么、读什么、学什么。然后对下面四个判断(做什么、什么被允许、哪里必须有人点头、结果好不好),逐个说明它在这个仓库的哪里有写,或者没有写。把任何会让新人觉得这套配置很重的地方标出来。不要修改任何文件。

Go deeper

延伸閱讀

延伸阅读

You can stop here: that is the whole idea. The next part shows where it runs, so you can look inside.讀到這裡就夠了,這就是整個想法。下一部分告訴你它在哪裡運行,可以進去看看。读到这里就够了,核心思路就是这些。下一部分告诉你它在哪里跑,可以进去看看。

In my practice (Copilot Harness)實作实战

Copilot Harness is my open-source harness for VS Code Copilot.

Repository: https://github.com/Smars-Bin-Hu/copilot-agentic-harness

Get started: clone it, open it in VS Code, and type /harness-rookie-get-me-ready in Copilot Chat. You need Python 3.9 or later and git.

Copilot Harness 是我開源的 VS Code Copilot harness。

倉庫: https://github.com/Smars-Bin-Hu/copilot-agentic-harness

開始:clone 下來,用 VS Code 打開,在 Copilot Chat 裡輸入 /harness-rookie-get-me-ready。需要 Python 3.9 以上和 git。

Copilot Harness 是我开源的 VS Code Copilot harness。

仓库: https://github.com/Smars-Bin-Hu/copilot-agentic-harness

上手:把仓库 clone 下来,用 VS Code 打开,在 Copilot Chat 里输入 /harness-rookie-get-me-ready。需要 Python 3.9 及以上版本和 git。

Explore it in the harness

The guided first setup and the first lesson run in Copilot Harness. The harness can show them to you with the real files. After the setup above, type:

/harness-rookie-wondering I have read the chapter "People and teams". Teach me how this harness gets a newcomer started: the guided first setup, the first lesson and its practice task that a team can replace with its own. Open the real files with me, and show what a new person sees in the first hour.

It teaches one small piece at a time, stops to ask if you are following, and opens the files with you.

在 harness 裡探索

引導式的第一次設定和第一堂課,在 Copilot Harness 裡執行。harness 可以用真實的檔案給你看。照上面的說明準備好之後,輸入:

/harness-rookie-wondering 我讀完了「人與團隊:留給人的事」這一章。請教我這個 harness 怎麼讓新人開始:引導式的第一次設定、第一堂課,以及團隊可以換成自己的練習任務。帶我打開真實的檔案,並讓我看新人在第一個小時看到什麼。

它一次教一小塊,停下來確認你跟得上,然後和你一起打開檔案。

在 harness 里探索

带引导的首次配置和第一课,都在 Copilot Harness 里跑着。harness 可以带着真实的文件把它们展示给你。按上面的说明准备好之后,输入:

/harness-rookie-wondering 我读完了“人与团队:留给人的事”这一章。请教我这个 harness 是怎么让新人上手的:带引导的首次配置、第一课,以及团队可以换成自己内容的练习任务。带我打开真实的文件,并展示新人在第一个小时里会看到什么。

它一次只教一小块,停下来确认你跟上了,再和你一起打开文件。