技能汇报
- 作者仓库星标 435
- 作者仓库 agr
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @computerlovetech · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
第 1 步:确定技能
如果从上下文中看不出来明显的话,询问哪项技能正在得到改进。然后找到源: 两种情况——它们有不同的更新路径: 情况 · 源位置 · 更新路径 In-repo (`{path = "./skills/<name>", type = "skill"}` in `agr.toml`) · `skills/<name>/` · 编辑源 → 提交 → `agr upgrade <name>`
第 2 步:接收反馈
听着。用户调用此技能是因为他们有话要说——让他们说吧。不要审问。不要向他们列出问题清单。接受他们提供的一切,无论他们提供什么形式。仅当您确实无法在没有一项技能的情况下继续进行时,才提出澄清问题(例如,用户指定的一项技能不存在,或者两项技能共享该技能)
第 3 步:提出变更建议
总结您所听到的内容,然后提出具体的修改建议。格式:对`skills/<name>/SKILL.md`(以及任何参考文献)的建议更改: 1. 描述 — 添加触发短语“...”(因为:...) 2. 边界 — 添加:从不 X(因为:在会话中发现这一点) 3. 新部分“Y” — 描述缺少的工作流程
第 4 步:申请(回购案例)
编辑`skills/<name>/`下的源文件。然后:不要推。提交后停止并让用户在准备好时推送。
第5步:申请(远程案例)
如果技能是远程部门,则无法直接应用更改。询问用户他们想要哪条路径:
第 6 步:验证
重新安装后(in-repo 情况): 对于远程情况(已提交问题):与用户确认问题 URL。告诉用户已完成的操作和待处理的操作(提交已完成、推送待处理;或已提交问题、等待响应)。
# Skill Debrief
Capture lessons from a session into the skill that drove it. The default
shape is **listen → propose → align → apply → re-install**.
## When to use
Trigger when the user wants to debrief an existing SKILL.md based on what
happened in the session. Examples:
- "debrief the X skill" / "let's debrief X"
- "retrospective on X" / "feedback on X"
- "improve the X skill" / "let's update X based on what we learned"
- "X skill should also handle …"
- "X didn't trigger when it should have"
Do NOT use this skill for:
- **Greenfield skill authoring.** Use `agr init` to scaffold a SKILL.md and
defer the body content to the user — or to a dedicated authoring skill
such as `anthropics/skills/skill-creator`
(`agr add anthropics/skills/skill-creator`).
- **Installing / syncing / removing skills.** That's plain `agr` CLI work
(`agr add`, `agr sync`, `agr upgrade`, `agr remove`).
## Step 1: Identify the skill
Ask which skill is being improved if it isn't obvious from context. Then
locate the source:
```bash
agr list # see installed deps and short names
ls skills/ # in-repo source if present
cat agr.toml # see whether the dep is local-path or remote
```
Two cases — they have different update paths:
| Case | Source location | Update path |
|---|---|---|
| **In-repo** (`{path = "./skills/<name>", type = "skill"}` in `agr.toml`) | `skills/<name>/` | Edit source → commit → `agr upgrade <name>` |
| **Remote** (`{handle = "user/repo/<name>", …}`) | Upstream GitHub repo | Cannot edit directly — see Step 5 |
If the skill isn't installed at all but the user wants to improve it, ask
whether to add it first (and which case applies).
## Step 2: Receive feedback
**Listen.** The user invoked this skill because they have something to say
— let them say it. Do not interrogate. Do not run a checklist of questions
at them. Take in whatever they offer, in whatever shape they offer it.
Only ask a clarifying question if you genuinely cannot proceed without one
(e.g. the user named a skill that doesn't exist, or two skills share the
name and you need to disambiguate). Even then, ask the minimum.
Be **dynamic**. The user may surface things in any shape — a single
sentence ("the description should also fire on X"), a structured list, or a
ramble that you need to distill. They may also surface things outside the
standard buckets below (rename a section, restructure `references/`, change
output format, drop a deprecated workflow, fix a typo). Apply whatever the
user actually says.
The buckets below are a mental map for *you* when distilling what you
heard, not a checklist to recite at the user:
- **`description` / triggers** — under-fired or over-fired
- **Gotchas / boundaries** — a foot-gun the skill didn't warn about
- **Workflow steps** — missing, wrong, or out of order
- **References** — a topic kept needing more depth → new `references/<topic>.md`
- **Examples / output format** — vague where it should be concrete
- **Pruning** — outdated content that misled
## Step 3: Propose changes
Summarize what you heard, then propose specific edits. Format:
> **Proposed changes to `skills/<name>/SKILL.md`** (and any references):
>
> 1. **Description** — add trigger phrase "…" (because: …)
> 2. **Boundaries** — add: never X (because: discovered this in session)
> 3. **New section "Y"** — describes the workflow that was missing
>
> Want me to apply these, revise, or add more?
For small edits, show the exact diff inline. For larger changes, summarize
first and apply section by section.
**Wait for explicit user approval before editing.** "yes" / "go ahead" /
similar. If the user revises, loop back to Step 2 or 3.
## Step 4: Apply (in-repo case)
Edit the source file(s) under `skills/<name>/`. Then:
```bash
git status # confirm only the intended files changed
git add skills/<name>/
git commit -m "skill(<name>): <one-line summary>"
agr upgrade <name> # re-installs into all configured tools, refreshes agr.lock
git add agr.lock
git commit --amend --no-edit # or commit separately; match the repo's style
```
**Do not push.** Stop after the commit and let the user push when ready.
### Commit message style
Use a conventional-commits-style scope:
```
skill(<name>): <imperative summary>
```
Examples:
```
skill(agr-cli): clarify upgrade vs sync for local paths
skill(agr-cli): add gotcha for same-repo siblings
skill(code-review): drop outdated linter pre-check
```
If the repo's commit style differs (check `git log --oneline -20`), match it.
### Why `agr upgrade` and not `agr sync`?
`agr sync` only installs **missing** deps — it does NOT re-copy a local-path
skill that's already installed. `agr upgrade <name>` re-copies it and
refreshes `agr.lock`. Use `agr upgrade`.
(Equivalent: `agr add ./skills/<name> --overwrite`. Pick `upgrade` for
consistency — it's the same verb used to refresh remote skills.)
## Step 5: Apply (remote case)
If the skill is a remote dep, the change cannot be applied directly. Ask
the user which path they want:
### Option A — File an issue upstream via `gh`
Best when the change benefits everyone (a real bug or universal improvement
in someone else's published skill).
Resolve the upstream repo from the handle:
- `anthropics/skills/pdf` → `--repo anthropics/skills`
- `user/myrepo/skill` → `--repo user/myrepo`
Confirm the title and body with the user, then:
```bash
gh issue create \
--repo <owner>/<repo> \
--title "[<skill-name>] <short summary>" \
--body "$(cat <<'EOF'
## What I observed
<concrete scenario from the session>
## Suggested change
<proposed wording or workflow>
## Why
<reasoning>
EOF
)"
```
`gh issue create` posts publicly — treat it the same as any other shared-
state action. **Always confirm before running.**
If the user has push access and a local clone, also offer to open a PR
instead of (or alongside) the issue.
### Option B — Fork to in-repo
Best when the change is project-specific or unlikely to be accepted
upstream. Copies the skill into `skills/<name>/` so future retros work the
in-repo way.
Suggested flow:
```bash
# 1. Find the upstream commit (agr.lock has it)
agr list
# 2. Sparse-checkout or full clone, then copy the folder:
mkdir -p skills
cp -r /tmp/upstream-clone/<skill-folder> skills/<name>
# 3. Swap the dep
agr remove anthropics/skills/<name>
agr add ./skills/<name>
```
Tell the user this **forks** the skill — they're now responsible for
keeping it current with upstream. Then continue from Step 3 with the
in-repo flow.
### Both A and B
Offer Option A first when the change is generally useful. Offer Option B
when upstream is unlikely to accept, or when the user wants the change
*now* without waiting on upstream.
## Step 6: Verify
After re-installing (in-repo case):
```bash
agr list # status should be `installed`
diff skills/<name>/SKILL.md .claude/skills/<name>/SKILL.md # should be empty
```
For remote case (issue filed): confirm the issue URL with the user.
Tell the user what's done and what's pending (commit done, push pending; or
issue filed, awaiting response).
## Boundaries
- **Don't edit a skill without explicit user approval of the proposed
changes.** Skills are user-owned content — never silently revise.
- **Don't push.** Commit only; the user pushes when ready.
- **Don't open issues or PRs without confirming the title and body** with
the user first. `gh issue create` is publicly visible — treat it as
shared-state.
- **Don't edit `agr.lock` by hand** — `agr upgrade` regenerates it.
- **Don't broaden the scope of the edit** beyond what was discussed. If the
user asked to fix one gotcha, don't also restructure the file.
- **Don't write a skill from scratch** — that's a separate workflow.
## See also
- `anthropics/skills/skill-creator` — canonical greenfield skill authoring
(install with `agr add anthropics/skills/skill-creator` if needed)
章节与文件索引
按说明文件中的顺序排列。
何时使用
第 1 步:确定技能
第 2 步:接收反馈
第 3 步:提出变更建议
第 4 步:申请(回购案例)
文件/命令 -> agr init · anthropics/skills/skill-creator · agr add anthropics/skills/skill-creator · agr · agr add · agr sync · agr upgrade · agr remove
内容校验值 -> c397bc32ae74
当前原文的自动摘译,尚未人工审校。
何时使用
当用户想要根据会话中发生的情况汇报现有 SKILL.md 时触发。示例:“汇报 X 技能”/“让我们汇报 X”“回顾 X”/“对 X 进行反馈”“改进 X 技能”/“让我们根据学到的知识更新 X”
第 3 步:提出变更建议
总结您所听到的内容,然后提出具体的修改建议。格式:对
skills/<name>/SKILL.md(以及任何引用)的建议更改: 1. 描述 — 添加触发短语“...”(因为:...) 2. 边界 — 添加:从不 X(因为:在会话中发现这一点) 3. 新部分“Y” — 描述缺少的工作流程