Chỉ dẫn và một tệp tham khảo
Kỹ năng hữu ích đơn giản nhất gồm chỉ dẫn cộng với một tệp tham khảo mà nhân viên chỉ đọc khi cần. Trình kích hoạt bổ sung từ ngữ vào mục của kỹ năng trong danh sách của nhân viên, giúp nhân viên khớp với những yêu cầu được diễn đạt theo nhiều cách khác nhau.
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."
Kỹ năng chạy script
Dùng script khi công việc cần câu trả lời chính xác, chẳng hạn tính toán số học hoặc chuyển đổi tệp. Nhân viên chạy script bằng execute, truyền các đối số mà script đọc dưới dạng JSON từ SKILL_ARGS. Bất cứ thứ gì script in ra stdout chính là kết quả. Script này chỉ dùng thư viện chuẩn của 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,
})) Thông tin bí mật và quyền truy cập mạng
Script không có quyền truy cập mạng trừ khi kỹ năng khai báo năng lực network, và khi đó cũng chỉ tới các kho gói và các tên miền trong metadata.allowed_domains. Thông tin bí mật được khai báo trong metadata.secrets sẽ đến dưới dạng biến môi trường có tên theo key của nó. Vì thông tin bí mật là bắt buộc, execute sẽ từ chối chạy cho đến khi chủ sở hữu đặt nó.
---
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()) Kỹ năng dùng plugin
Khi một kỹ năng cần một plugin cụ thể, hãy liệt kê plugin đó trong plugins. Nếu plugin chưa được cài, kỹ năng vẫn được nạp nhưng bị đánh dấu là suy giảm, để chủ sở hữu thấy còn thiếu gì. Nên viết kỹ năng xoay quanh năng lực và để nhân viên dùng bất kỳ kết nối nào sẵn có; chỉ khai báo plugin khi chỉ dẫn thực sự phụ thuộc vào nó.
---
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. Tiếp theo
- Tài liệu tham khảo SKILL.md: mọi trường và biến.
- Phát hành: tải lên một kỹ năng và các tệp của nó.