Community程式設計與開發github.com

steipete/one-password

1Password / op CLI 技能:優先使用服務帳戶,在 tmux 中進行精確的機密讀取、儲存與注入。

one-password 是什麼?

此技能為 AI 代理(如 Claude Code、Cursor 等)提供完整的 1Password CLI (`op`) 整合指南。其核心設計原則為「非互動優先」,強制所有 `op` 命令在單一持久化 tmux 會話中執行,從而繞過預設的 TTY 限制,實現安全且穩定的機密管理。技能首先嘗試使用服務帳戶(Service Account Token)進行無需解鎖桌面應用的自動化操作,僅在必要時(如服務帳戶無權限)才自動降級至桌面應用授權流程,並盡量減少對用戶互動的請求。它詳細說明了帳戶選擇(預設使用 `my.1password.com`)、精確的欄位讀取(透過 JSON 解析避免重複欄位)、安全的機密寫入模式以及明確的搜尋規範,旨在防止機密值洩漏、會話混亂或範圍過大的列舉。此技能支援 macOS、Linux 等平台上的 1Password CLI,並與 tmux 深度整合,特別適合需要即時存取個人或服務機密的開發者工作流程。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/one-password

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

1Password CLI

請遵循官方 CLI 入門步驟。不要猜測安裝指令。

參考資料

工作流程

  1. 檢查作業系統與 shell。
  2. 在 tmux 內驗證 CLI 是否存在:op --version。
  3. 必要:為整個機密任務建立剛好一個持久化的具名 tmux 會話。
  4. 當有相符的權杖/工作流程存在時,優先嘗試使用範圍限定的服務帳戶存取;無需對話框。
  5. 如果缺少服務帳戶存取權限,或無法取得確切的項目/欄位,則在同一會話中自動嘗試桌面應用程式備援方案。請勿先要求聊天許可。
  6. 桌面備援:觸發應用程式整合/解鎖,然後在同一會話中執行 op signin。1Password 提示是用戶同意的邊界;僅在提示無法顯示或完成時才在聊天中詢問。
  7. 在同一個會話中驗證所選的存取路徑:op whoami。
  8. 如果有多個帳戶:使用 --account 或 OP_ACCOUNT。
  9. 如果指令失敗,請使用 tmux send-keys 重複使用同一個 tmux 會話;不要為了重試而啟動第二個會話。

預設帳戶

  • 個人/工作機密的預設帳戶是 my.1password.com。
  • 除非明確要求,否則不要擅自使用 my.1password.eu / Titan。
  • 在儲存或讀取機密時,請在每個 op 指令中傳遞 --account my.1password.com。不要依賴環境帳戶選擇。
  • op account list 僅是元數據,但仍需在 tmux 內執行。當路由不明確時,用它來確認帳戶名稱。
  • op signin --account my.1password.com 可能返回狀態碼 0 但沒有有用輸出,且仍可能導致後續 shell 未登入。建議在同一個 tmux shell 中執行登入、新增/編輯/取得以及驗證。

服務帳戶權杖

  • 在任何互動式 1Password 流程之前,優先使用服務帳戶權杖。使用者對話框僅作為備援方案。
  • 1Password 服務帳戶是針對特定保管庫/範圍的非互動權杖,適用於無需解鎖桌面應用程式的自動化操作。
  • Peter 的預設服務帳戶權杖透過 Codex 管理的區塊,從 ~/.profile 匯出為 OP_SERVICE_ACCOUNT_TOKEN。其範圍限定於受限的 Molty 保管庫。
  • 較舊的 shell 可能將相同值暴露為 MOLTY_OP_SERVICE_ACCOUNT_TOKEN;將其視為已知 Molty 保管庫項目的備援別名。
  • 如果權杖尚未匯出、不適用,或無法讀取確切的已知項目/欄位,請自動使用下方的桌面應用程式 1Password 流程。僅在實際解鎖或其他使用者互動仍受阻時才詢問。
  • 僅將權杖匯出/傳遞給需要它的單一指令:OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" op item get "<known item>" --vault Molty ...。
  • 服務帳戶的 op 讀取需要明確的保管庫查詢;省略 --vault Molty 即使權杖有效也會失敗。
  • 保持 tmux 規則:每個 op 指令,包括服務帳戶讀取,仍須在一個具名 tmux 會話內執行。
  • 預設情況下,不要使用服務帳戶列舉保管庫/項目。如果使用者明確要求搜尋、提供螢幕截圖/列表,或僅提供模糊的項目名稱,請在使用桌面備援方案之前,先使用下方的安全元數據搜尋。
  • 僅顯示存在性/形狀,切勿顯示權杖或機密值。

必需的持久化 Tmux 會話

Shell 工具每個指令使用全新的 TTY。在一個專用的 tmux 會話內執行 op,並持續使用同一個會話直到整個機密任務完成。服務帳戶指令仍然在此執行,但不得觸發應用程式提示。

範例:

SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawdbot-tmux-sockets}"
mkdir -p "$SOCKET_DIR"
SOCKET="$SOCKET_DIR/clawdbot-op.sock"
SESSION="op-work"

tmux -S "$SOCKET" has-session -t "$SESSION" 2>/dev/null ||
  tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "op signin --account my.1password.com" Enter
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "op whoami" Enter
tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION:" -S -200

在遇到引號、項目名稱或指令失敗後,不要建立新的 tmux 會話。將修正後的指令發送到現有會話中。 將會話定位為 $SESSION:,而不是假設視窗 0;較舊的會話可能從 1 開始索引視窗。

特定服務的工作流程

  • 將特定服務的身份驗證詳細資訊保留在所屬的技能中。
  • 對於 npm registry/套件工作,使用 $npm;它記錄了 Molty 服務帳戶項目、非互動式認證包裝器和套件預留輔助工具。
  • 此技能僅擁有通用的 1Password 規則:僅在 tmux 中使用 op、目標明確的讀取、一個持久化會話、不進行廣泛列舉、不輸出機密。

已知有效的機密寫入模式

使用持久化 tmux 會話。將確切的機密任務寫入暫存腳本,然後將該腳本傳送到 op-work 會話中;不要為了重試而建立第二個 tmux 會話。

SOCKET_DIR="${CLAWDBOT_TMUX_SOCKET_DIR:-${TMPDIR:-/tmp}/clawdbot-tmux-sockets}"
SOCKET="$SOCKET_DIR/clawdbot-op.sock"
SESSION="op-work"
tmux -S "$SOCKET" has-session -t "$SESSION" 2>/dev/null ||
  tmux -S "$SOCKET" new -d -s "$SESSION" -n shell

cat > /tmp/op-store-secret.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
ACCOUNT="my.1password.com"
ITEM_TITLE="Service API Tokens"
FIELD_NAME="api_token"
EXPECTED_PREFIX=""
NOTES="Created via tmux-safe op workflow"
TOKEN="$(pbpaste)"
if [ -n "$EXPECTED_PREFIX" ]; then
  case "$TOKEN" in "$EXPECTED_PREFIX"*) ;; *) echo "clipboard value does not match expected prefix" >&2; exit 2;; esac
fi
op item create --account "$ACCOUNT" --category "API Credential" --title "$ITEM_TITLE" "$FIELD_NAME[password]=$TOKEN" "notesPlain=$NOTES" >/dev/null
op item get "$ITEM_TITLE" --account "$ACCOUNT" --fields "label=$FIELD_NAME" >/dev/null
echo "stored and verified secret field without printing it"
SCRIPT
chmod 700 /tmp/op-store-secret.sh
tmux -S "$SOCKET" send-keys -t "$SESSION" -- "bash /tmp/op-store-secret.sh; rm -f /tmp/op-store-secret.sh" C-m

在此 CLI 版本中,op 的類別字串是區分大小寫且人類可讀的;請使用 "API Credential",而非 api_credential。

精確欄位讀取

對於已知項目,在實際使用前先驗證欄位形狀:長度、預期前綴、換行數,但絕不顯示值。當項目具有重複/舊版憑證欄位時,op --field NAME 和 --fields label=NAME 可能返回錯誤的隱藏欄位。如果形狀錯誤,請以 JSON 格式讀取已知項目並提取確切的標籤。

cat > /tmp/op-read-field.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
ITEM_TITLE="Known API Credential Item"
FIELD_LABEL="api_token"
VAULT="Molty"
value="$(
  OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" \
    op item get "$ITEM_TITLE" --vault "$VAULT" --format json |
    FIELD_LABEL="$FIELD_LABEL" node -e 'let s=""; process.stdin.on("data",d=>s+=d); process.stdin.on("end",()=>{const item=JSON.parse(s); const f=(item.fields||[]).find(x=>x.label===process.env.FIELD_LABEL); if(!f?.value) process.exit(2); process.stdout.write(f.value);})'
)"
echo "field_len:${#value}"
case "$value" in sk-*) echo "field_prefix:sk" ;; *) echo "field_prefix:other" ;; esac
echo "field_has_newline:$(printf %s "$value" | wc -l | tr -d ' ')"
SCRIPT
chmod 700 /tmp/op-read-field.sh
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "bash /tmp/op-read-field.sh; rm -f /tmp/op-read-field.sh" C-m

將 JSON 提取範圍限制在已知項目和保管庫。不要為了發現候選項目而列舉保管庫/項目。

明確項目搜尋

僅在使用者明確要求搜尋、提供螢幕截圖/列表,或確切標題猜測失敗且使用者要求正則表達式/模糊查詢時使用。保持保管庫範圍限定且僅限元數據;印出候選項目標題/ID/類別/保管庫名稱,切勿印出欄位或值。優先使用螢幕截圖中的確切可見字串:保管庫名稱、項目標題和欄位標籤。

cat > /tmp/op-find-item.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
VAULT="Molty"
QUERY="minimax"
OP_SERVICE_ACCOUNT_TOKEN="$OP_SERVICE_ACCOUNT_TOKEN" \
  op item list --vault "$VAULT" --format json |
  QUERY="$QUERY" VAULT="$VAULT" node -e '
let s=""; process.stdin.on("data",d=>s+=d); process.stdin.on("end",()=>{
  const q=process.env.QUERY.toLowerCase();
  const vault=process.env.VAULT;
  const items=JSON.parse(s).filter(x => [
    x.title, x.id, x.category, ...(x.tags || [])
  ].filter(Boolean).join("\n").toLowerCase().includes(q));
  for (const item of items.slice(0, 10)) {
    console.log(`title:${item.title} id:${item.id} category:${item.category || ""} vault:${vault}`);
  }
  console.log(`matches:${items.length}`);
})'
SCRIPT
chmod 700 /tmp/op-find-item.sh
tmux -S "$SOCKET" send-keys -t "$SESSION:" -- "bash /tmp/op-find-item.sh; rm -f /tmp/op-find-item.sh" C-m

選定候選項目後,切換回精確的項目/欄位 JSON 提取和僅形狀驗證。確切的已知個人項目可能會自動使用桌面備援方案;除非使用者要求搜尋,否則不要廣泛列舉個人保管庫。

過濾除錯

將整個管線保持在同一個 tmux 會話內。檢查狀態和輸出長度,絕不檢查機密值。

cat > /tmp/op-debug.sh <<'SCRIPT'
#!/usr/bin/env bash
set -euo pipefail
set +x
SIGNIN_OUTPUT="$(op signin --account my.1password.com 2>&1 || true)"
echo "signin output bytes: ${#SIGNIN_OUTPUT}"
op account list 2>&1 | sed -E "s/(xox[baprs]-)[A-Za-z0-9-]+/\\1REDACTED/g; s/(xapp-)[A-Za-z0-9-]+/\\1REDACTED/g"
SCRIPT
chmod 700 /tmp/op-debug.sh
tmux -S "$SOCKET" send-keys -t "$SESSION" -- "bash /tmp/op-debug.sh; rm -f /tmp/op-debug.sh" C-m

護欄

  • 切勿將機密貼到日誌、聊天或程式碼中。
  • 優先使用 op run / op inject,而非將機密寫入磁碟。
  • 如果需要無應用程式整合的登入,請使用 op account add。
  • 如果指令返回「account is not signed in」,請在 tmux 內重新執行 op signin 並在應用程式中授權。
  • 讓桌面版 1Password 解鎖提示直接請求使用者互動;請勿事先添加單獨的聊天許可往返。
  • 不要在 tmux 外部執行 op;如果 tmux 不可用,請停止並詢問。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

相關技能