personal-agent-foundation

对话式安装、恢复和验证 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 做项目对齐门禁时。

汇总全部治理层飞书 Profile 的任务与近期日历、Obsidian 仪表盘以及已登记 Agent 项目状态，判断用户现在最值得执行的一个下一步，并给出可立即开始的行动、完成标准、建议投入时长、选择依据和少量备选。用于用户询问“下一步做什么”“现在该干什么”“先做哪个”“当前最值得推进什么”，或面对多个项目和任务难以判断轻重缓急时。默认只读，不创建任务、不修改项目、不写 Obsidian、不生成完整日程、不写日历；需要记录任务时转交 feishu-task，需要规划或重排一段时间时转交 personal-schedule-planner。

管理飞书/Lark CLI 的多 Profile 与用户授权生命周期。用于用户要求连接、添加、登录、授权、重新授权、检查、切换、重命名、删除或迁移飞书账号/Profile，换电脑或 CLI 工作区后恢复身份，飞书操作因 Profile 缺失、token 失效、授权撤销、身份不明、应用失效或配置冲突而中断，以及需要判断账号规则应放入 GLOBAL 还是具体项目时。负责生成一键创建应用链接、OAuth 链接和二维码，维护项目局部身份路由规则，但不保存任何密钥或动态令牌。

当 Agent 需要通过 GitHub CLI (`gh`) 操作 GitHub 时使用：检查认证和 active 账号、在多个 GitHub 账号之间切换、查看仓库/Issue/PR/Actions、搜索或安装 GitHub CLI skills、使用 `gh api`，或规划评论、创建 PR、Release、Secrets、Variables、Workflow 运行、仓库变更等安全写操作。用户询问 GitHub CLI 的使用、安装、登录、配置或排错时也使用。

在创建、安装或同步用户自维护全局 Skill 后，或用户主动安装外部 Skill 后，维护 GLOBAL/SKILL_DEPENDENCIES.md。用户要求记录 Skill 依赖、更新 SKILL_DEPENDENCIES.md、安装外部 Skill 后登记、新增全局 Skill 后登记，或维护 GLOBAL/SKILL_DEPENDENCIES.md 时使用。不要用于默认预装 Skill、系统 Skill、插件提供的 Skill、插件缓存 Skill 或临时运行文件。

用于页面和应用界面的视觉迭代工作流判断，提醒 Agent 在可见 Web 页面上做 UI/UX 修改时优先考虑浏览器点选式迭代，尤其是 Impeccable Live Mode。用户提到“点击修改页面”“点某个位置改”“这里看着不对”“现场看页面调设计”“生成几个变体”“局部视觉修改”，或在浏览器预览中指出 layout/spacing/overlap/color/typography/copy/motion 等具体问题时使用。也用于设计初稿生成后，提醒在继续手动 patch 前先考虑 Live Mode。不用于纯后端、非视觉重构、CLI-only 工作或一次性静态解释。