指令和一个参考文件
最简单而实用的技能,就是指令加上一个员工只在需要时才读取的参考文件。触发词会为员工列表中的这个技能条目补充词语,帮助它匹配用不同方式表达的请求。
weekly-status/
├── SKILL.md
└── references/
└── format.md --- name: weekly-status description: Write the weekly status update from the week's finished work, open items and risks. Use when someone asks for a weekly update, a status report or a Friday summary. triggers: [status report, weekly update, friday summary] --- # Weekly status 1. Collect what was finished this week, what is still open, and anything at risk. 2. Read references/format.md with read_skill_file and follow its layout exactly. 3. Keep each section to five bullets or fewer. Lead with outcomes, not activity. 4. End with the one decision you need from the reader, or write "No decisions needed."
运行脚本的技能
当工作需要精确的答案时(例如算术或文件转换),就使用脚本。员工用 execute 运行它,并传入参数,脚本从 SKILL_ARGS 中以 JSON 形式读取这些参数。脚本输出到 stdout 的任何内容就是结果。这个脚本只用了 Python 标准库。
invoice-totals/
├── SKILL.md
└── scripts/
└── totals.py ---
name: invoice-totals
description: Add up invoice line items, apply a tax rate, and report the subtotal, tax and total. Use when someone asks to total, check or recalculate an invoice.
version: "1.0.0"
---
# Invoice totals
Never add numbers in your head. Run the script:
execute(skill: "invoice-totals", script: "scripts/totals.py",
args: { "items": [{ "description": "...", "quantity": 2, "unit_price": 40.0 }], "tax_rate": 0.08 })
Report the subtotal, tax and total from the script's output, and list any line
item the script flagged. import json
import os
args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
items = args.get("items", [])
rate = float(args.get("tax_rate", 0))
subtotal = 0.0
flagged = []
for item in items:
qty = item.get("quantity", 0)
price = item.get("unit_price", 0)
if qty <= 0 or price < 0:
flagged.append(item.get("description", "unnamed item"))
continue
subtotal += qty * price
tax = round(subtotal * rate, 2)
print(json.dumps({
"subtotal": round(subtotal, 2),
"tax": tax,
"total": round(subtotal + tax, 2),
"flagged": flagged,
})) 密钥和网络访问
除非技能声明了 network 能力,否则脚本无法访问网络;即使声明了,也只能访问软件包仓库和 metadata.allowed_domains 中的域名。在 metadata.secrets 中声明的密钥,会以其 key 命名的环境变量传入。由于该密钥是必需的,在所有者设置它之前,execute 会拒绝运行。
---
name: company-lookup
description: Look up a company's size, industry and headquarters from its web domain. Use when someone asks who a company is or wants a prospect researched.
version: "1.0.0"
capabilities: [network]
metadata:
allowed_domains: [api.example.com]
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create a key at https://example.com/settings/keys
required: true
---
# Company lookup
Run scripts/lookup.py with the domain:
execute(skill: "company-lookup", script: "scripts/lookup.py", args: { "domain": "example.com" })
If the script reports that the key is missing, ask the owner to add it with
configure_skill. Report only what the lookup returned; say so when a field is empty. import json
import os
import urllib.request
domain = json.loads(os.environ.get("SKILL_ARGS", "{}")).get("domain", "")
req = urllib.request.Request(
"https://api.example.com/v1/companies?domain=" + domain,
headers={"Authorization": "Bearer " + os.environ["EXAMPLE_API_KEY"]},
)
with urllib.request.urlopen(req, timeout=20) as resp:
print(resp.read().decode()) 使用插件的技能
当技能需要某个特定插件时,把它列在 plugins 下。如果该插件未安装,技能仍会加载,但会被标记为降级状态,以便所有者看到缺少了什么。最好围绕能力来编写技能,让员工使用它已有的任何连接;只有当指令确实依赖某个插件时,才声明它。
---
name: month-end-close
description: Walk through the month-end close checklist, reconcile each account and list what still needs the owner. Use at month end or when someone asks to close the books.
version: "1.0.0"
plugins:
- name: example-ledger
version: ">=2.0.0"
---
# Month-end close
For each balance-sheet account, in chart-of-accounts order, read its balance and unreconciled transactions from the ledger, reconcile what
matches, and list what does not. Never lock a period yourself; ask the owner. 下一步
- SKILL.md 参考:所有字段和变量。
- 发布:上传技能及其文件。