用途
Manager 是一个 GitHub issues 双向桥接技能,属于 Personal Corp 框架(通过 AI 智能体运营一人公司)。其定位是把会话中完成的工作与 GitHub issues 打通:GitHub issues 是任务的事实来源,GitHub Project 看板是“本周哪些任务处于活跃状态”的事实来源。Manager 是 issue 工作流的规范入口,官方说明要求:这类操作不要退回到通用 issue 助手,manager 负责读—改—写契约、不变式和 Project 同步。
两种模式
写模式(同步):在会话结束时执行。读取本次做了什么、查找已有 issue、用进度和一条工作记录评论更新,维持父 epic / W-标签 / Project 不变式,只有在没有任何匹配时才新建 issue。触发信号包括用户说“sync session”“зафиксируй”“обнови issues”,或在会话末尾不带参数调用 /manager,或明确列出产物/变更。
读模式(查询):随时使用。问题形式如“track X 怎么样了”“Y 的状态”,跨仓库搜索并返回匹配 issue 的浓缩状态,包含父 epic、标签、Project 放置位置与最近活动。触发信号是用户询问状态的问题。读模式下不向 GitHub 写入。
主要能力与不变式
Manager 对每个触及的 issue 维持基础三条不变式,活跃/当周 issue 还需满足 Project 与工作记录不变式:
- W-标签:当前或未来周(或特定有日期事件的日期),若配置中启用了 W-标签约定;仓库中不存在该标签则创建。
- 父 epic:通过 GitHub Sub-issues API 恰好有一个父级;非 epic 本身的 issue 必须有父级。
- 以标题 + epic 成员关系区分 track,不使用 track 标签。
- Project 放置:活跃/当周 issue 须出现在其领域 Project 看板(若有)和全局周 Project 上;有 W-标签却无 Project 放置视为 Project drift。
- Project 可见父级:活跃/当周子 issue 不能只靠 parent_issue_url,可见的根 epic 本身须在相关 Project 视图中且有非空状态泳道。
- 工作记录评论:写模式下,仅当本次会话在该 issue 上发生了真实工作时,才必须追加时间线评论,总结所做工作并附提交链接;仅改状态/标签/Project 放置不能替代它,纯机械重标或 Project 修复则不加评论。
若任何仓库都不存在父 epic,manager 会在同步前于提案中提出并提供创建或选择已有 epic 的选项,绝不留下孤立 issue。
配置方式
首次使用前需在项目的 CLAUDE.md 中定义 Manager Config,包括:GitHub owner(用于 issue 搜索的用户名或组织);待扫描仓库列表(跨仓库搜索范围);可选的任务索引文件路径(manager 在 gh search 之前先读它来限定查询范围);领域到仓库的路由表(如 commercial/B2B 交易→crm、产品发布→main、ops/基础设施→ops、内容→marketing);GitHub Projects 集成(如 weekly_project、weekly_project_owner、status_field、status_in_progress,可选按领域的项目编号);W-标签约定(enabled、format 如 W{NN} 表示 ISO 周);固定写入授权(mode 为 ask-each-time 或 execute-after-plan,默认 ask);可选 CRM 集成(crm_path、crm_pointer_format)。无需单独的 init 技能,该配置段即初始化。标题类型元数据不在此配置,而由标签、父级树和 Projects 承载。
使用流程要点
运行前必须先执行预检(两种模式皆然),且预检保持静默:先读任务索引文件,用高 limit 快照周 Project,检查相关仓库 git 状态,必要时计算当前 ISO 周,并行的 gh 读取尽量并发。写模式先根据对话上下文推断产物,做静默预检与跨仓库搜索,形成 5–15 行简要执行计划,再按授权模式执行;遇到真正的歧义或风险(无合适父 epic、仓库/track 归属不确定、公开仓库隐私风险、破坏性/批量变更、范围未明确完成的关单、证据冲突)时先询问。
提交与 issue 关联方面,会话中的每次提交应携带 trailer,如 refs $YOUR_OWNER/<repo>#N 或 closes $YOUR_OWNER/<repo>#N;## Updates 中的带日期条目列出各触及仓库本次会话提交的短 SHA;产物须先提交并推送再链接,正文/报告中的链接必须是可点击的 GitHub URL 而非本地路径。若会话产出 PRD、计划或图,完整内容应放入 issue 正文(含上下文、决策表、mermaid 图、schema、MVP 切片、范围外、待解问题),本地 md 可作为工作副本,二者分歧时以 issue 正文为准。
读模式流程:解析查询对象,执行多关键词跨仓库搜索(简单 track 用一条 gh search issues,3 个以上关键词用批量 GraphQL),过滤误匹配,对真实匹配用一次批量 GraphQL 拉取实时状态(标题、state、标签、父级、projectItems 状态泳道、最近活动),解析 track epic 与 sub_issues_summary,交叉参考任务索引并标注热点,输出带 Project 列的浓缩表格、待解问题、未覆盖缺口与 drift 提示。
适用场景
适合使用 manager 的情形:会话结束时用“同步会话”/“/manager”把实际产物(CRM 更新、会议卡片、代码提交、文档)同步进 issue;会话开始或进行中查询某 track 的跨仓库状态,避免手工 grep;决定下一步前查看已有什么开着。不适合:在没有产物时创建新想法(应使用头脑风暴);未经用户明确指示关闭 issue;批量 CRM 更新(那是 CRM 技能而非 manager)。
限制与注意
输出语言跟随用户输入语言与项目约定,技术记号(issue 名、标签、命令、文件路径、引用中的原标题)保持原样不翻译;新 issue 标题语言遵循用户 locale,英语仅允许作为专有名词(产品名、仓库名、品牌、API 名、公共上游术语)。manager 不重写任务索引本身,索引整理属于周计划技能的工作。读模式从不写入 GitHub。
暂未提供
该技能的收费、价格、平台支持范围、安装命令与部署步骤在资料中暂未提供。