메뉴
当 Agent 需要通过 GitHub CLI (`gh`) 操作 GitHub 时使用：检查认证和 active 账号、在多个 GitHub 账号之间切换、查看仓库/Issue/PR/Actions、搜索或安装 GitHub CLI skills、使用 `gh api`，或规划评论、创建 PR、Release、Secrets、Variables、Workflow 运行、仓库变更等安全写操作。用户询问 GitHub CLI 的使用、安装、登录、配置或排错时也使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
对话式安装、恢复和验证 Personal Agent Foundation。用于用户给出 DongLiStudio/personal-agent-foundation 仓库链接并要求安装，或要求部署完整 GLOBAL、换电脑恢复 Agent 工作环境、配置默认飞书 Profile/GitHub 账号/Obsidian 连接、完成首次项目初始化教程时。自动获取完整产品源、准备运行时，并调用确定性护栏完成 dry-run、staging 渲染、目标保护、安装后验证和 onboarding。
使用用户的项目制管理规则初始化 Agent 项目工作区。当用户要求初始化项目、创建项目、创建新项目、scaffold/register Agent project、创建 README.md、STATUS.md、AGENTS.md、.gitignore、docs、tasks、archive、初始化 Git，或登记到 GLOBAL/PROJECTS.md 时使用。项目本地 Skill/agent 内容遵循 Agent 管理的 `.agents` 机制。
通用飞书任务创建、补全、去重、更新与回读流程。用于用户要求添加、创建、记录、安排或同步飞书任务/待办，或提供聊天记录、截图、会议材料和附件并希望转成可执行飞书任务时。执行前复用或按需补充当前项目的“项目任务协调员”；自动解析账号/Profile、人员角色、时间、任务详情、附件与验收标准；任务写入后判断新增、时间、负责人、状态或工作量变化是否影响当前用户排程，必要时联动 personal-schedule-planner 生成修订草案；附件含密码、令牌、2FA 密钥等局部秘密时，制作并上传不可逆脱敏副本；项目明确指定飞书账号时遵循项目规则，未指定时继承 GLOBAL 记录的全局默认 Profile。
汇总 GLOBAL 记录的全部飞书 Profile 下的任务与日历、Obsidian 仪表盘以及已登记 Agent 项目进度，生成从现在开始的个人时间安排，并在用户确认后幂等同步到所有 Profile 日历。用于用户要求规划今天、未来几天或本周，询问接下来做什么、重排时间块、把同一计划同步到多个飞书账号，在早晨及工作开始时制定可执行日程，或 feishu-task 创建/更新时间、负责人、状态和工作量后移交了影响当前用户排程的任务变更。执行前复用或按需补充通用助手的“个人时间管理员”；默认只读采集并先协商，未经确认不写日历，不递归遍历 Obsidian。
当 GLOBAL 发生会影响项目的规则、路径、Skill 源头、账号工具约定、项目索引或治理入口更新后，动态读取 GLOBAL_CONTEXT.md 及本次相关 GLOBAL 规则，审计、计划并在授权后逐项目对齐所有已登记 Agent 项目。用于 GLOBAL 规则更新后的递归项目扫描、项目继承/合理覆盖/冲突判断、旧路径或失效入口清理、migrate-agent-root 迁移前后项目对齐门禁，以及生成逐项目/总报告；不用于纯文案修正、GLOBAL 内部实现调整或不影响项目的易变运行状态。
安全迁移 Agent 根目录、GLOBAL 与已登记项目。用于用户要求移动或更换 Agent 根目录、迁移 GLOBAL 和全部项目、修复旧根绝对路径、重建 Obsidian/知识库链接、同步自维护全局 Skill 安装副本，或在迁移后调用 align-agent-projects-with-global 做项目对齐门禁时。
| name | github-cli |
| description | 当 Agent 需要通过 GitHub CLI (`gh`) 操作 GitHub 时使用：检查认证和 active 账号、在多个 GitHub 账号之间切换、查看仓库/Issue/PR/Actions、搜索或安装 GitHub CLI skills、使用 `gh api`，或规划评论、创建 PR、Release、Secrets、Variables、Workflow 运行、仓库变更等安全写操作。用户询问 GitHub CLI 的使用、安装、登录、配置或排错时也使用。 |
使用 gh 处理 GitHub 托管状态和协作流程。使用本地 git 处理本地仓库状态、diff、分支、commit 和 remote。优先使用官方 gh 子命令；只有高层命令无法满足时才使用 gh api。
gh 前先确认目标仓库。在本地仓库中检查 git remote -v；不在仓库中时，要求或推断 OWNER/REPO，并传入 -R OWNER/REPO。gh auth status
{{AGENT_ROOT}}\GLOBAL\GITHUB_ACCOUNTS.md，再确认 active 账号与目标项目或用户意图匹配。gh auth switch --hostname github.com --user <username>
gh auth token 和 gh auth status --show-token。任何写操作前，先用只读命令建立上下文：
gh repo view OWNER/REPO
gh issue view 123 -R OWNER/REPO --comments
gh pr view 123 -R OWNER/REPO --comments
gh pr checks 123 -R OWNER/REPO --json bucket,completedAt,link,name,state,workflow
gh run list -R OWNER/REPO
gh run view <run-id> -R OWNER/REPO --log
优先使用 --json 配合 --jq 或模板获得机器可读结果。命令支持 --web 时，除非用户希望打开浏览器，否则不要使用。
以下操作必须有明确用户意图后再执行：创建/编辑/关闭 Issue 或 PR、PR 评论/Review、push 分支、merge PR、创建/发布/删除 Release、workflow dispatch/rerun/cancel、Secret 或 Variable 变更、仓库创建/删除/归档/可见性变更、deploy key、SSH/GPG key，以及 GitHub CLI extension/skill 安装。
高影响写操作前，说明目标账号、仓库、操作和主要参数。可行时先使用非变更预览，例如 gh pr diff、gh pr view、gh release view、gh workflow view、gh api --method GET。
任务涉及 PR、Issue、Actions/CI、Release、gh api 或 GitHub CLI skills 时，读取 references/commands.md 获取具体命令模式。账号生命周期、项目路由、remote 与首次 push 读取 references/account-routing.md。
gh，在 Windows 上先检查 %LOCALAPPDATA%\Programs\GitHub CLI\gh.exe，再询问是否安装或修复 PATH。gh auth login --hostname github.com --git-protocol https --web，并把浏览器/设备授权指引返回给用户。gh auth refresh --scopes <scope>。