request-access
GitHub当命令需要未授权的密钥链凭证时,向所有者发送访问请求。通过 API 提交申请,等待审批后自动重试命令,确保权限合规且流程自动化。
Trigger Scenarios
Install
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.
Version History
- b4f4b30 Current 2026-11-02 10:52
- 6803edb 2026-10-18 18:22


