Kilo Gas Town Mayor 深度指南用对话式协调 Agent 管理你的自治编码小镇【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode导读在 Kilo 的 Gas Town 自治编码平台中Mayor镇长是你与整个 agent 团队之间的唯一对话式入口它常驻运行、负责把高层的自然语言需求转化为可执行的任务计划convoy并持续跟踪、调度、排查小镇内的所有工作。读完本文你将掌握 Mayor 的核心职责、21 个底层管理工具、五大实战使用场景、高效沟通技巧以及它的能力边界从而学会用自然语言指挥一整个 AI 开发团队。本文以 mayor.md 为骨架并结合 concepts.md、sling-work.md、settings.md 等文档进行纵深展开。Mayor 是什么小镇的常驻技术负责人Gas Town 的 agent 团队由三种角色构成Mayor 是其中负责统筹的一环Agent角色职责Polecat编码 agent写代码读取代码、在独立 git worktree 中修改、跑测试、推送分支多个可并行工作Refinery审查 agent代码审查审查 polecat 的输出、运行质量检查、合并通过的工作Mayor镇长协调你的对话式接口规划工作、回答问题、排查问题、让一切持续推进与 polecat 这种按需拉起、处理完单个 bead 就退出的工作方式不同Mayor 是持续运行的——即使当前没有任何编码 agent 在干活Mayor 也随时在线等待你的指令或问题。从职责上看Mayor 相当于一个常驻技术负责人technical lead它具体承担五类工作规划工作Plans work——把高层描述转化为 convoy多任务编队和 bead工作单元汇报状态Reports status——清楚每个 agent 在做什么、什么卡住了、什么已经交付排查问题Triages issues——调查失败任务、卡死 agent 和升级事件escalation配置小镇Configures the town——更新设置、管理 rig、调整 agent 行为回答问题Answers questions——回答关于代码库、工作历史和镇内状态的问题值得一提的是Mayor 的常驻特性与小镇的持久化设计相辅相成town 会跨会话保留工作历史、agent 配置和关于代码库的机构知识见 concepts.md而 Mayor 正是读取和操作这些持久状态的最直接入口。与 Mayor 对话入口与会话模型从你的小镇仪表盘town dashboard打开Mayor 面板即可开始对话。会话是持久化的——在同一个会话内Mayor 会记住之前消息的上下文因此你可以进行多轮追问而无需每次重复背景。你可以把它想象成在小镇上 了一下负责人所有关于小镇的问题和指令都可以直接发给它从大家现在在干嘛到帮我创建一个三阶段的迁移 convoy。五大实战使用场景场景一规划工作Planning Work让 Mayor 帮你创建工作是它的核心能力之一。例如Create a convoy to add authentication to the API. We need JWT token generation, middleware for protected routes, and integration tests.创建一个 convoy 为 API 增加认证功能。需要 JWT token 生成、受保护路由的中间件以及集成测试。Mayor 收到后会执行三步拆解——把这个需求分解成带依赖关系的多个 bead提案——给出一个 convoy 计划供你审阅创建——创建 convoy默认处于 staged 暂存状态你可以先审阅再让 agent 开工这里涉及两个 Gas Town 核心概念bead最小工作单元有open/in_progress/in_review/closed/failed的生命周期和convoy多 bead 工作流bead 之间可以互相依赖形成 DAG由 reconciler 保证只有前置依赖满足时才会派发 agent详见 concepts.md。staged convoy 的默认行为可以在小镇设置里调整Staged Convoys Default默认true见 settings.md。场景二检查状态Checking StatusMayor 对镇内一切有完全可见性可以直接问Whats everyone working on?大家都在忙什么Is anything stuck?有什么卡住了吗How did the last convoy go?上一个 convoy 结果如何它能给出每个 agent 的状态、bead 的进展以及最近的历史记录。除了对话你还可以在小镇的rig 页面看到 convoy 跟踪器每条 bead 的状态和依赖关系一目了然和实时更新的 kanban 看板open / in progress / in review / closed 四列或在beads 页面按状态、类型、rig 过滤所有工作项详见 sling-work.md。场景三排查问题Investigating Problems当任务异常时先问 Mayor 而不是自己去翻管理后台The auth refactor bead has been in progress for 20 minutes — whats happening?Why did the refinery reject the last review?Mayor 可以检查 agent 状态消息、审查反馈和容器日志来诊断问题。结合 Gas Town 的**微对抗循环micro-adversarial loop**设计——polecat 写完代码后由 refinery 独立审查被拒后返回修订超过最大修订轮数默认 3 次则 bead 标记为failed并创建 escalation 等待人工处理见 code-review.md——你可以让 Mayor 顺着这条链路定位卡在哪一轮。场景四更新配置Updating ConfigurationMayor 可以用自然语言直接修改小镇设置Switch the model to Auto Frontier for this town把小镇模型切换到 Auto FrontierSet max polecats to 4把最大 polecat 数量设为 4Add a custom instruction: always use TypeScript strict mode添加自定义指令始终使用 TypeScript strict 模式这些配置项对应小镇设置中的真实参数详见 settings.md模型配置默认模型可选Kilo Auto Frontier最高质量、效果最好或Kilo Auto Efficient按任务难度匹配合适模型、成本最低还可以为 mayor、refinery、polecat 分别设置角色级模型覆盖Agent 上限Max Polecats Per Rig 默认 21-2 保守、3-4 适中、5 激进自定义指令一段注入到每个 agent 系统提示词的自由文本可编码项目约定、架构决策、风格偏好、约束和测试要求场景五回答问题Answering QuestionsMayor 对代码库、工作历史和镇内状态都有了解可以作为小镇的机构知识查询入口。当然需要说明的是Mayor 的知识范围限于小镇内部可见的信息见下文能力边界。Mayor 的 21 个专用工具Mayor 拥有21 个专用工具用于小镇管理分为五类。这些工具在收到你的请求时自动调用你不需要直接执行它们但了解其能力能帮你更精准地提出需求。工作创建Work Creation工具作用gt_sling把单个任务委派给指定 rig 中的某个 polecat agentgt_sling_batch创建多 bead 的 convoy支持依赖排序、合并模式和暂存选项编队管理Convoy Management工具作用gt_convoy_status显示 convoy 的详细状态——每个 bead 的进度和分配对象gt_convoy_start启动一个 staged convoy——开始派发 agentgt_convoy_close强制关闭 convoy可选地同时关闭其跟踪的 beadsgt_convoy_update编辑 convoy 元数据合并模式、功能分支gt_convoy_add_bead把一个已有 bead 加入 convoy 的跟踪范围gt_convoy_remove_bead从 convoy 中移除某个 beadgt_list_convoys列出活动中的 convoy 及其进度计数工作单元管理Bead Management工具作用gt_bead_update编辑 bead 的状态、标题、正文、优先级、标签或依赖gt_bead_reassign把 bead 重新分配给另一个 agentgt_bead_delete删除一个或多个 bead支持批量最多 5000 个gt_list_beads列出 rig 中的 beads可按状态和类型过滤Agent 管理Agent Management工具作用gt_agent_reset强制把 agent 重置为空闲状态使其脱离当前 beadgt_nudge给某个 polecat 发送实时提醒立即、等待空闲或排队模式gt_list_agents列出 rig 中所有 agent 及其角色和状态gt_mail_send向任意 rig 中的任意 agent 发送持久化的邮件消息小镇与界面Town UI工具作用gt_list_rigs列出小镇中的所有 rig仓库连接gt_ui_action触发界面操作——打开抽屉、页面导航、高亮元素gt_escalation_acknowledge确认某条升级事件已被审阅gt_report_bug在 Gastown 的 GitHub 仓库提交 bug 报告先检查重复项从这五类工具可以看出 Mayor 的职责边界非常清晰它负责调度、编排、状态管理、配置和沟通而把写代码留给 polecat、把审代码留给 refinery——这与下文Mayor 不写代码的定位完全一致。高效沟通技巧如何让 Mayor 真正帮你干活文档给出了三条经过验证的沟通原则本质是用明确的信息换取可靠的行为技巧一把范围说具体模糊的请求会得到模糊的执行。对比不要只说Fix the bugs修 bug而是说Fix the TypeScript type errors in src/auth/. There are 3 reported in the CI output.修复 src/auth/ 下的 TypeScript 类型错误CI 输出里报了 3 个技巧二复杂工作交给 convoy单次完成的 agent 输出存在质量天花板——任务越长错误累积的可能性越大。对比不要只说Add a user dashboard with charts, settings, and notifications而是说Create a staged convoy for the user dashboard. Break it into: 1) dashboard layout and navigation, 2) chart components with mock data, 3) settings page, 4) notification system. Each should build on the previous.创建一个 staged convoy拆成 4 个相互承接的步骤convoy 的价值在于分解成小而可审查的块、排序让后一步构建在已审查合并的代码之上、逐块审查每个独立贡献、隔离失败——如果第 3 步失败前两步已经安全合并见 sling-work.md。结合微对抗循环代码在进入 main 分支前会经过 per-bead 审查、上下文累积、landing review 等多轮审查从源码结构看这正是 Gas Town 区别于单 agent 工具的核心设计。技巧三让 Mayor 先排查出问题时先让 Mayor 调查而不是自己钻进管理后台Bead abc123 has been stuck for 30 minutes — can you investigate?Mayor 通常能直接诊断并解决问题——重置卡死的 agent、关闭卡住的 convoy、重新派发工作——这些操作恰好对应gt_agent_reset、gt_convoy_close、gt_sling等工具。沟通边界与注意事项原文档明确列出了 Mayor 的四条限制理解它们能避免错误预期Mayor 负责协调但不写代码——写代码是 polecat 的职责它只能看到小镇内部的情况——无法感知外部系统复杂的多仓库编排可能需要在多个小镇之间手动协调上下文窗口有限——非常长的对话可能丢失早期上下文建议在长会话中适时开启新会话另外值得补充的是Mayor 的行为模型、模型选择可以在设置中为 mayor 角色单独指定更快的模型以及与 reconciler 的关系都值得了解真正驱动小镇前进的是 reconciler——它在工作活跃时每 5 秒触发一次 alarm tick负责排空事件、评估规则、发出动作、强制不变量如不重复派发、无孤儿 hook、有界重试而 Mayor 只是你面向这套自主引擎的对话式遥控器见 concepts.md。小结Mayor 是 Gas Town 这个多 agent 自治平台中你与系统之间的那层人话翻译器它把自然语言变成带依赖的 convoy 计划gt_sling_batch把状态查询变成对镇内数据的实时读取gt_list_beads、gt_convoy_status把配置调整变成对小镇设置的写入。想上手体验可先阅读 quick-start.md 创建第一个小镇再对照 index.md 理解整体架构随后用本文的沟通技巧与 Mayor 对话逐步把日常开发工作交给这支持续在线的技术负责人。【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Kilo Gas Town Mayor 深度指南：用对话式协调 Agent 管理你的自治编码小镇
Kilo Gas Town Mayor 深度指南用对话式协调 Agent 管理你的自治编码小镇【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode导读在 Kilo 的 Gas Town 自治编码平台中Mayor镇长是你与整个 agent 团队之间的唯一对话式入口它常驻运行、负责把高层的自然语言需求转化为可执行的任务计划convoy并持续跟踪、调度、排查小镇内的所有工作。读完本文你将掌握 Mayor 的核心职责、21 个底层管理工具、五大实战使用场景、高效沟通技巧以及它的能力边界从而学会用自然语言指挥一整个 AI 开发团队。本文以 mayor.md 为骨架并结合 concepts.md、sling-work.md、settings.md 等文档进行纵深展开。Mayor 是什么小镇的常驻技术负责人Gas Town 的 agent 团队由三种角色构成Mayor 是其中负责统筹的一环Agent角色职责Polecat编码 agent写代码读取代码、在独立 git worktree 中修改、跑测试、推送分支多个可并行工作Refinery审查 agent代码审查审查 polecat 的输出、运行质量检查、合并通过的工作Mayor镇长协调你的对话式接口规划工作、回答问题、排查问题、让一切持续推进与 polecat 这种按需拉起、处理完单个 bead 就退出的工作方式不同Mayor 是持续运行的——即使当前没有任何编码 agent 在干活Mayor 也随时在线等待你的指令或问题。从职责上看Mayor 相当于一个常驻技术负责人technical lead它具体承担五类工作规划工作Plans work——把高层描述转化为 convoy多任务编队和 bead工作单元汇报状态Reports status——清楚每个 agent 在做什么、什么卡住了、什么已经交付排查问题Triages issues——调查失败任务、卡死 agent 和升级事件escalation配置小镇Configures the town——更新设置、管理 rig、调整 agent 行为回答问题Answers questions——回答关于代码库、工作历史和镇内状态的问题值得一提的是Mayor 的常驻特性与小镇的持久化设计相辅相成town 会跨会话保留工作历史、agent 配置和关于代码库的机构知识见 concepts.md而 Mayor 正是读取和操作这些持久状态的最直接入口。与 Mayor 对话入口与会话模型从你的小镇仪表盘town dashboard打开Mayor 面板即可开始对话。会话是持久化的——在同一个会话内Mayor 会记住之前消息的上下文因此你可以进行多轮追问而无需每次重复背景。你可以把它想象成在小镇上 了一下负责人所有关于小镇的问题和指令都可以直接发给它从大家现在在干嘛到帮我创建一个三阶段的迁移 convoy。五大实战使用场景场景一规划工作Planning Work让 Mayor 帮你创建工作是它的核心能力之一。例如Create a convoy to add authentication to the API. We need JWT token generation, middleware for protected routes, and integration tests.创建一个 convoy 为 API 增加认证功能。需要 JWT token 生成、受保护路由的中间件以及集成测试。Mayor 收到后会执行三步拆解——把这个需求分解成带依赖关系的多个 bead提案——给出一个 convoy 计划供你审阅创建——创建 convoy默认处于 staged 暂存状态你可以先审阅再让 agent 开工这里涉及两个 Gas Town 核心概念bead最小工作单元有open/in_progress/in_review/closed/failed的生命周期和convoy多 bead 工作流bead 之间可以互相依赖形成 DAG由 reconciler 保证只有前置依赖满足时才会派发 agent详见 concepts.md。staged convoy 的默认行为可以在小镇设置里调整Staged Convoys Default默认true见 settings.md。场景二检查状态Checking StatusMayor 对镇内一切有完全可见性可以直接问Whats everyone working on?大家都在忙什么Is anything stuck?有什么卡住了吗How did the last convoy go?上一个 convoy 结果如何它能给出每个 agent 的状态、bead 的进展以及最近的历史记录。除了对话你还可以在小镇的rig 页面看到 convoy 跟踪器每条 bead 的状态和依赖关系一目了然和实时更新的 kanban 看板open / in progress / in review / closed 四列或在beads 页面按状态、类型、rig 过滤所有工作项详见 sling-work.md。场景三排查问题Investigating Problems当任务异常时先问 Mayor 而不是自己去翻管理后台The auth refactor bead has been in progress for 20 minutes — whats happening?Why did the refinery reject the last review?Mayor 可以检查 agent 状态消息、审查反馈和容器日志来诊断问题。结合 Gas Town 的**微对抗循环micro-adversarial loop**设计——polecat 写完代码后由 refinery 独立审查被拒后返回修订超过最大修订轮数默认 3 次则 bead 标记为failed并创建 escalation 等待人工处理见 code-review.md——你可以让 Mayor 顺着这条链路定位卡在哪一轮。场景四更新配置Updating ConfigurationMayor 可以用自然语言直接修改小镇设置Switch the model to Auto Frontier for this town把小镇模型切换到 Auto FrontierSet max polecats to 4把最大 polecat 数量设为 4Add a custom instruction: always use TypeScript strict mode添加自定义指令始终使用 TypeScript strict 模式这些配置项对应小镇设置中的真实参数详见 settings.md模型配置默认模型可选Kilo Auto Frontier最高质量、效果最好或Kilo Auto Efficient按任务难度匹配合适模型、成本最低还可以为 mayor、refinery、polecat 分别设置角色级模型覆盖Agent 上限Max Polecats Per Rig 默认 21-2 保守、3-4 适中、5 激进自定义指令一段注入到每个 agent 系统提示词的自由文本可编码项目约定、架构决策、风格偏好、约束和测试要求场景五回答问题Answering QuestionsMayor 对代码库、工作历史和镇内状态都有了解可以作为小镇的机构知识查询入口。当然需要说明的是Mayor 的知识范围限于小镇内部可见的信息见下文能力边界。Mayor 的 21 个专用工具Mayor 拥有21 个专用工具用于小镇管理分为五类。这些工具在收到你的请求时自动调用你不需要直接执行它们但了解其能力能帮你更精准地提出需求。工作创建Work Creation工具作用gt_sling把单个任务委派给指定 rig 中的某个 polecat agentgt_sling_batch创建多 bead 的 convoy支持依赖排序、合并模式和暂存选项编队管理Convoy Management工具作用gt_convoy_status显示 convoy 的详细状态——每个 bead 的进度和分配对象gt_convoy_start启动一个 staged convoy——开始派发 agentgt_convoy_close强制关闭 convoy可选地同时关闭其跟踪的 beadsgt_convoy_update编辑 convoy 元数据合并模式、功能分支gt_convoy_add_bead把一个已有 bead 加入 convoy 的跟踪范围gt_convoy_remove_bead从 convoy 中移除某个 beadgt_list_convoys列出活动中的 convoy 及其进度计数工作单元管理Bead Management工具作用gt_bead_update编辑 bead 的状态、标题、正文、优先级、标签或依赖gt_bead_reassign把 bead 重新分配给另一个 agentgt_bead_delete删除一个或多个 bead支持批量最多 5000 个gt_list_beads列出 rig 中的 beads可按状态和类型过滤Agent 管理Agent Management工具作用gt_agent_reset强制把 agent 重置为空闲状态使其脱离当前 beadgt_nudge给某个 polecat 发送实时提醒立即、等待空闲或排队模式gt_list_agents列出 rig 中所有 agent 及其角色和状态gt_mail_send向任意 rig 中的任意 agent 发送持久化的邮件消息小镇与界面Town UI工具作用gt_list_rigs列出小镇中的所有 rig仓库连接gt_ui_action触发界面操作——打开抽屉、页面导航、高亮元素gt_escalation_acknowledge确认某条升级事件已被审阅gt_report_bug在 Gastown 的 GitHub 仓库提交 bug 报告先检查重复项从这五类工具可以看出 Mayor 的职责边界非常清晰它负责调度、编排、状态管理、配置和沟通而把写代码留给 polecat、把审代码留给 refinery——这与下文Mayor 不写代码的定位完全一致。高效沟通技巧如何让 Mayor 真正帮你干活文档给出了三条经过验证的沟通原则本质是用明确的信息换取可靠的行为技巧一把范围说具体模糊的请求会得到模糊的执行。对比不要只说Fix the bugs修 bug而是说Fix the TypeScript type errors in src/auth/. There are 3 reported in the CI output.修复 src/auth/ 下的 TypeScript 类型错误CI 输出里报了 3 个技巧二复杂工作交给 convoy单次完成的 agent 输出存在质量天花板——任务越长错误累积的可能性越大。对比不要只说Add a user dashboard with charts, settings, and notifications而是说Create a staged convoy for the user dashboard. Break it into: 1) dashboard layout and navigation, 2) chart components with mock data, 3) settings page, 4) notification system. Each should build on the previous.创建一个 staged convoy拆成 4 个相互承接的步骤convoy 的价值在于分解成小而可审查的块、排序让后一步构建在已审查合并的代码之上、逐块审查每个独立贡献、隔离失败——如果第 3 步失败前两步已经安全合并见 sling-work.md。结合微对抗循环代码在进入 main 分支前会经过 per-bead 审查、上下文累积、landing review 等多轮审查从源码结构看这正是 Gas Town 区别于单 agent 工具的核心设计。技巧三让 Mayor 先排查出问题时先让 Mayor 调查而不是自己钻进管理后台Bead abc123 has been stuck for 30 minutes — can you investigate?Mayor 通常能直接诊断并解决问题——重置卡死的 agent、关闭卡住的 convoy、重新派发工作——这些操作恰好对应gt_agent_reset、gt_convoy_close、gt_sling等工具。沟通边界与注意事项原文档明确列出了 Mayor 的四条限制理解它们能避免错误预期Mayor 负责协调但不写代码——写代码是 polecat 的职责它只能看到小镇内部的情况——无法感知外部系统复杂的多仓库编排可能需要在多个小镇之间手动协调上下文窗口有限——非常长的对话可能丢失早期上下文建议在长会话中适时开启新会话另外值得补充的是Mayor 的行为模型、模型选择可以在设置中为 mayor 角色单独指定更快的模型以及与 reconciler 的关系都值得了解真正驱动小镇前进的是 reconciler——它在工作活跃时每 5 秒触发一次 alarm tick负责排空事件、评估规则、发出动作、强制不变量如不重复派发、无孤儿 hook、有界重试而 Mayor 只是你面向这套自主引擎的对话式遥控器见 concepts.md。小结Mayor 是 Gas Town 这个多 agent 自治平台中你与系统之间的那层人话翻译器它把自然语言变成带依赖的 convoy 计划gt_sling_batch把状态查询变成对镇内数据的实时读取gt_list_beads、gt_convoy_status把配置调整变成对小镇设置的写入。想上手体验可先阅读 quick-start.md 创建第一个小镇再对照 index.md 理解整体架构随后用本文的沟通技巧与 Mayor 对话逐步把日常开发工作交给这支持续在线的技术负责人。【免费下载链接】kilocodeKilo is the all-in-one agentic engineering platform. Build, ship, and iterate faster with the most popular open source coding agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kilocode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考