SuperAPI AI 工具集

position

通用与其它

查看项目

更新于 10-15 20:10

技能介绍

position 是通用队友引导技能,命令为 /position <name>,从 ai-workspace/team/<name>.md 加载岗位档案,并按档案定义的会话启动流程执行,使会话以该岗位身份运行至结束。

用途与区分:岗位(position)是每次队友会话持久加载的身份(如 tpm、software-engineer、technical-editor、architect),存放在 ai-workspace/team/;角色(role)是 /task 步骤上一次性派发的活动(如 implementer、code-reviewer),存放在 ai-workspace/agents/。position 只处理岗位,一次性角色应使用工具的子代理派发机制。

主要能力:解析 NAME、PROFILE、STATE_DIR;档案不存在时拒绝并列出可用岗位(ls ai-workspace/team/*.md),不自动引导;按序读取必要档案及同级状态目录中的 PLAYBOOK.md、DECISIONS.md(多数岗位无状态目录则静默跳过);按档案规定重新生成实时状态(如 TPM 使用 gh project item-list、git worktree list、gh pr list);确认并接管岗位,必要时发布注册消息。

使用方式:/position <name> 加载并引导;/position <name> --resume 表示恢复中断会话,读取 .branch-context.md、跳过注册消息,档案无恢复语义时静默忽略;再次调用 /position <other> 可切换岗位,后者生效,tpm 岗位按自身规则拒绝中途切出。部分岗位附带包装技能(如 /tpm),优先使用包装以启用岗位特定契约;未安装时可直接用 /position tpm。

限制:档案缺失时属于契约性拒绝,不可自动引导;不应从 agents/ 目录读取岗位;带状态岗位需同时加载状态目录;须先完整加载再推理;不得把子代理角色当作岗位调用。