mcpField
B
bitwarden-personal-profile

bitwarden-personal-profile

github.com/arthurzakirov生产力1163 次安装2 周前更新
代码仓库

关于 bitwarden-personal-profile

Bitwarden Personal Profile 是一项技能，可从本地私密档案或 Bitwarden Secrets Manager 安全读取稳定的个人信息。它让其他技能按需加载字段，并避免将真实信息写入代码仓库或日志。

主要功能

  1. 01加载规范化档案数据
  2. 02验证档案结构
  3. 03导入和导出 Bitwarden 密钥
  4. 04按输出语言选择字段
  5. 05将真实信息保存在本地私密状态

适用场景

  1. 01用已存个人信息填写表单
  2. 02提供符合目标语言的档案字段
  3. 03在本地存储与 Bitwarden 间迁移档案

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/arthurzakirov/agentdesk --skill bitwarden-personal-profile

安装后在 Claude Code 中输入/bitwarden-personal-profile确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
bitwarden-secrets-manager-schema.md
language-policy.md
personal-profile.example.yaml
personal-profile.schema.json
scripts/
bitwarden_to_profile.py
init-private-profile.sh
load_profile.py
materialize_profile.py
profile_lib.py
profile_to_bitwarden_import.py
profile_to_bws_secret.py
validate_profile.py

详细介绍

Bitwarden 个人资料

约定

使用此技能访问 Bitwarden 中稳定的个人信息，且不将隐私值提交到版本库。

  • 此技能中附带了架构和虚构示例。
  • 真实个人资料值必须存储在版本库之外。
  • 优先使用 $ADC_PERSONAL_PROFILE_PATH；否则使用 ~/.config/AgentDesk/personal-profile.yaml。
  • 除非用户明确要求提供这些值，否则切勿将真实个人资料值写入此技能文件夹、公开版本库、日志、屏幕截图或最终答复。

工作流程

  1. 查找私人个人资料。

    • 如果已设置 $ADC_PERSONAL_PROFILE_PATH，则使用它。
    • 否则使用 ~/.config/AgentDesk/personal-profile.yaml。
    • 如果文件不存在，且用户使用 Bitwarden Secrets Manager，请运行 scripts/bitwarden_to_profile.py。
    • 如果 Bitwarden 不可用，请运行 scripts/init-private-profile.sh，并让用户填写生成的本地文件。

  2. 使用前进行验证。

    • 运行 scripts/validate_profile.py "$ADC_PERSONAL_PROFILE_PATH" 或使用默认路径。
    • 如果验证失败，请停止。

  3. 使输出语言与目标表单一致。

    • 阅读 references/language-policy.md。
    • 对于英文表单，优先使用 en 值。
    • 对于德文表单，优先使用 de 值。
    • 除非个人资料明确提供了译名，否则专有名称和官方名称保持不变。

  4. 仅加载任务所需的字段。

    • 使用 scripts/load_profile.py --json 获取规范化的 JSON。
    • 仅需少数字段时，不要将整个个人资料粘贴到对话中。

命令

根据虚构示例初始化本地私人个人资料：

skills/bitwarden-personal-profile/scripts/init-private-profile.sh

根据本地私人个人资料创建 Bitwarden Secrets Manager 导入 JSON：

skills/bitwarden-personal-profile/scripts/profile_to_bitwarden_import.py \
  "$HOME/.config/AgentDesk/personal-profile.yaml" \
  --project-name "AgentDesk" \
  --output "$HOME/.config/AgentDesk/bitwarden-personal-profile-import.json"

如果项目已存在，使用 bws 直接创建或更新密钥：

skills/bitwarden-personal-profile/scripts/profile_to_bws_secret.py \
  "$HOME/.config/AgentDesk/personal-profile.yaml" \
  --project-id "$BWS_PERSONAL_PROFILE_PROJECT_ID"

从 Bitwarden Secrets Manager 导出 JSON、bws 密钥 ID 或项目扫描结果生成本地文件：

skills/bitwarden-personal-profile/scripts/bitwarden_to_profile.py \
  --from-bws-project-id "$BWS_PERSONAL_PROFILE_PROJECT_ID" \
  --output "$HOME/.config/AgentDesk/personal-profile.yaml"

验证：

skills/bitwarden-personal-profile/scripts/validate_profile.py "$HOME/.config/AgentDesk/personal-profile.yaml"

加载规范化的 JSON：

skills/bitwarden-personal-profile/scripts/load_profile.py --json

Bitwarden 说明

将 Bitwarden Secrets Manager 用作私人事实来源。将个人资料 YAML 存储为单个密钥值，键为 ADC_PERSONAL_PROFILE_YAML。

直接使用 CLI 操作前，必须安装 Bitwarden Secrets Manager CLI 并完成身份验证：

export BWS_ACCESS_TOKEN="..."

生成的文件是本地私人状态，不是 Git 文件。

资源

  • references/personal-profile.schema.json：已提交的架构。
  • references/personal-profile.example.yaml：已提交的虚构示例。
  • references/language-policy.md：语言选择规则。
  • references/bitwarden-secrets-manager-schema.md：Bitwarden Secrets Manager 映射。
  • scripts/init-private-profile.sh：根据虚构示例创建本地私人个人资料路径。
  • scripts/profile_to_bitwarden_import.py：将个人资料 YAML 转换为 Bitwarden 导入 JSON。
  • scripts/profile_to_bws_secret.py：通过 bws 创建或更新个人资料密钥。
  • scripts/bitwarden_to_profile.py：从 Bitwarden 导入/导出 JSON 或 bws 生成个人资料文件。
  • scripts/materialize_profile.py：旧版 Password Manager 安全备注备用方案。
  • scripts/validate_profile.py：验证结构和语言映射。
  • scripts/load_profile.py：为其他技能加载私人个人资料。

评论

支持 Markdown