Agent Skills
› yc-software/qm
› request-access
request-access
GitHub当命令需要他人密钥链凭据且当前会话无授权时，向所有者发起访问请求。通过API提交申请，等待所有者在聊天界面点击审批卡片完成授权，随后自动重试被阻塞的命令。
触发场景
命令执行因缺少他人密钥链凭据而受阻
当前会话未包含所需凭据的授权句柄
安装
npx skills add yc-software/qm --skill request-access -g -y
SKILL.md
Frontmatter
{
"name": "request-access",
"description": "Ask a person for access to one of their keychain credentials when a command needs it and this conversation has no grant yet. The platform posts an approval card where this conversation is happening; the owner clicks it, and the blocked command re-runs."
}
Request access to someone's credential
Use this when a command needs someone's credential and the Credentials section shows no handle for it here. Your own credentials in your own personal conversation never need this.
Request
One call, from this session or any sub-agent. The approval belongs to the whole conversation, so every session in it sees the same grant.
curl -sS -X POST "$AGENT_API_URL/v1/keychain/asks" \
-H "x-agent-capability: $AGENT_API_TOKEN" -H 'content-type: application/json' \
-d '{"owner":"<their name or principal id>","service":"<service, e.g. github>","purpose":"<what the command will do>"}'
- The server finds the credential from
ownerandservice. If it can't tell which one you mean, it answers 404 or 409 withcandidates; pick one and send{"credential":"<its credential id>", ...}instead. purposeis one plain sentence about the command, not the whole task.- If a request for that credential is already pending, the same one comes back. Don't ask twice.
Where the card shows up
You don't choose. The card appears where this conversation is: the Slack thread or channel, inline in the web session (and in its parent when you are a sub-agent), or the scheduled job's destination. Only the credential's owner can click it; nothing said in chat is approval.
Then
- Tell the person in one short line that you asked the owner for access. No request ids, no request text, no "paused".
- Stop. Don't retry, poll, or work around the missing credential.
- When the owner approves, this conversation re-runs the blocked command on its own. Continue with one short line.
- If they deny or it expires, say so in one line and offer another way.
版本历史
- b4f4b30 当前 2026-11-02 10:52
- 6803edb 2026-10-18 18:22
