★ FEATURED ARTICLE AI 应用媒体生成后端前端【免费下载链接】pollinationsYour Friendly Open-Source Gen-AI Platform项目地址https://gitcode.com/gh_mirrors/po/pollinations点击查看免费下载issue-maker 是 Pollinations 仓库内置的一份Agent 技能约定规定 AI 助手在为团队记录工作时应如何在 GitHub 上创建或更新 Issue。读完本篇你将掌握该技能的完整操作准则与团队 ownership 表、它在仓库中的存放位置与镜像机制以及它与project_manager机器人、CI 触发器、Express 优先级作业之间的真实协作关系——即为什么技能里强调不要替机器人加 Area/Type/Priority 标签这些字段最终由谁、按什么规则自动写入 Dev 项目。一、issue-maker 技能是什么issue-maker是一份 Claude Code / Codex 可直接加载的技能文件采用标准的SKILL.md格式头部为 YAML front-matter正文为面向 Agent 的指令。其 front-matter 声明为--- name: issue-maker description: Create or update Pollinations GitHub issues when asked to track work, using current repository conventions. ---也就是说当用户要求把这件事记成一个 Issue / 跟进某项工作时Agent 应调用本技能遵循当前仓库约定current repository conventions来落地而不是凭感觉随意写。按根目录 AGENTS.md 的约定Maintain project skills in.claude/skills/… expose them to Codex through relative directory links in.agents/skills/技能的主维护副本放在 .claude/skills/issue-maker/SKILL.md并通过相对目录链接暴露给 Codex 的镜像位置 .agents/skills/issue-maker/SKILL.md。两份内容保持一致避免复制一份工作流造成的漂移。技能正文是 5 条指令加一张团队 ownership 表。下面逐条继承并展开。二、技能定义的五条核心准则技能正文.claude/skills/issue-maker/SKILL.md原文以要点列表给出使用pollinations/pollinations仓库在创建重复项或复活过期工作之前先检查相关的 open 与 closed 的 issues/PRs包括最新讨论与关闭原因。用简短标题 至多 3 个具体要点描述当前问题或期望结果关联相关工作当 Issue 覆盖多个步骤时使用 checklist。area、type、priority 由 project manager 机器人设置见operations/github/project-manager.md不要为它们加标签。遵循用户的 assignee 偏好否则使用下文团队 ownership 表不确定时核对当前仓库上下文。根AGENTS.md定义了 app-submission 状态。返回 Issue 链接与简洁摘要在被要求时使用 Discord 兼容的格式。仅做 Issue 的工作时不要创建或修改任何本地文件。下面按主题拆分并结合仓库给出每条准则的落地依据。2.1 固定仓库 创建前去重准则 1技能明确要求落在pollinations/pollinations仓库。这一取值与分诊机器人代码中的常量一致——operations/github/project_manager.py 中REPO_OWNER pollinations、REPO_NAME pollinations机器人对同一仓库的 Issue/PR 事件做响应。先去重不是建议而是硬性要求Agent 在动手创建前必须先检索相关的已开与已关闭的 issues/PRs并阅读最新讨论和关闭原因close reason。这与 AGENTS.md 中Before reviving old work, check its discussion, close reason, and remaining user-visible gap; an absent feature alone is not evidence that it is needed的告诫互为印证——单纯某功能不存在并不构成需要它的证据避免把早已讨论过、甚至被主动关闭的工作重新开出来。2.2 标题 ≤3 个要点 关联链接 checklist准则 2Issue 正文的格式被限制得相当克制一个短标题至多 3 个具体concrete要点并主动链接相关工作当 Issue 需要分步骤完成时改用 checklist勾选列表。这一风格与 AGENTS.md 的Communication Style一致PRs/comments/issues: bullets, 200 words, no fluffIssue comments: bullets only; facts not opinions; link code; be direct。换句话说仓库整体推崇要点化、事实导向、无营销废话的沟通issue-maker 只是把这套风格固化成 Agent 可执行的规则。2.3 不要替机器人加 Area/Type/Priority 标签准则 2 的后半句技能特别强调area、type、priority 由 project manager 机器人设置不要为它们添加标签。这条准则是整个技能的分工边界其依据见 AGENTS.md 的GitHub Project Manager一节A bot sets the Dev project Area on every new issue and PR, plus the issue type and Priority on issues, followingoperations/github/project-manager.md. … Labels are only for workflows (APP-*,BEE-CENSUS,HONEY-CENSUS,POLLI,NEWS,POLLEN-QUEST/DRAFT-QUEST,VOTING,MERGE-HOLD) and goals (REVENUE); dont repurpose them or create new labels ad hoc.也就是说标签labels在 Pollinations 里只服务于工作流和目标两类用途如APP-SUBMISSION、POLLEN-QUEST、VOTING、MERGE-HOLD、REVENUE而这个工作属于哪个领域/是什么类型/多紧急这三个维度由机器人写到Dev 项目的结构化字段里而不是写成标签。若人为去加这类标签会污染工作流标签的语义、也与机器人的字段写入产生冲突。这一机制的完整规则见下文幕后机制。2.4 Assignee 偏好 团队 ownership 表 app-submission 状态准则 3指派规则分三级优先遵循用户明确表达的 assignee 偏好否则按下文的团队 ownership 表选人拿不准时核对当前仓库上下文例如改动落在哪个目录、哪个服务再决定归属。技能同时点明app-submission 的状态机由根AGENTS.md定义。见 AGENTS.md 的App Submission HandlingAPP-SUBMISSION是持久类型标签APP-NEEDS-INFO、APP-REVIEW、APP-APPROVED描述评审状态由apps-review-submissions.yml与apps-publish-submissions.yml驱动目录真源是operations/app-management/app.json。因此 Agent 在为提交一个应用这类工作建 Issue 时不应自创标签而应沿用这套既定状态。2.5 返回链接与摘要 Discord 兼容格式准则 4技能要求 Agent 完成后返回 Issue 链接 一段简洁摘要并且在被要求时输出Discord 兼容的格式。这与仓库存在 Discord 协作面根AGENTS.md给出 Guild 用途相契合——许多记录工作的请求本身就来自 Discord 场景回复格式需要能被 Discord 正确渲染如 markdown 链接、要点列表。2.6 只记录、不落地本地文件准则 5仅做 Issue 的工作时不要创建或修改任何本地文件是一条安全护栏Agent 的职责是把工作登记到 GitHub而不是在仓库里顺手生成.md或脚本。这一点与 AGENTS.md 中Dont create.mddocs unless asked的总体纪律一致避免为了记一件事而在仓库里留下杂物。三、团队 ownership 表技能内置了一张三行 ownership 表作为用户没有指定 assignee时的默认指派依据原样继承自 .claude/skills/issue-maker/SKILL.mdPersonGitHubAreaThomasvoodoohopGeneral, models, infrastructureJoshuaeulervoidPollen, backend, authElliotelliotetagCommunity, newsletter, UI使用方式先尊重用户偏好没有偏好时按这件事主要落在谁的领域来指派。例如一条关于模型注册表 / GPU 基础设施的 Issue 倾向 Thomas一条关于 Pollen 计费 / 后端 / 鉴权的 Issue 倾向 Joshua一条关于社区目录 / 通讯 / 界面的 Issue 倾向 Elliot。技能还提醒当改动边界模糊时checking current repository context when uncertain——即回到这段工作主要改哪些目录/服务来判断这与下文 project manager 的按主要用途选领域思路同源。四、幕后机制Project Manager 机器人如何自动分类技能把 area/type/priority 的写入交给机器人下面用仓库源码说明这条自动分诊管线的真实构成帮助理解技能准则为何如此设计。4.1 单一事实来源project-manager.md分类简报operations/github/project-manager.md 是工作如何被组织的唯一权威定义机器人与团队都读同一份文件。其要点Area从 15 个领域里选一个Models、Community models、Agents agent tools、Developer tools、Accounts keys、Billing payments、Quests rewards、Dashboard、API reliability、CI releases、Internal automation、Brand news、Docs support、App catalog showcase、Data insights。TypeBug/Feature/TaskQuestion仅用于 IssuePR 用Work typeBug/Feature/Task。Priority仅 IssueHigh/Medium/Low。简报明确按今天对用户造成的伤害定级而非需求价值或谁提的Express由另一个作业稍后搬运机器人自己永不选 Express。Area rules按工作主要服务于哪个领域判断PR 按合并后代码做什么、改了哪些文件而非标题前缀判断quest 工作归其工作本身所属的领域POLLEN-QUEST本身不是归入Quests rewards的理由只 promote/sync/deploymain→production的 PR 以及 census 问卷作答返回null不进分类。Answer只返回 JSON形如{area: Models, type: Bug, priority: High, reasoning: one short sentence}area为null时type、priority均为null。简报里每个领域都写清了什么属于这里 / 什么不属于这里如模型定价→Models计费错误→Billing payments让分类有可核对的边界。4.2 实现project_manager.py的执行链operations/github/project_manager.py 把上述简报落成可运行逻辑。关键事实含源码定位输入来自 GitHub 事件GITHUB_EVENT解析出pull_request或issue取出number、title、body、作者、node_id等见 operations/github/project_manager.py。AI 分类ask_ai()调用 Pollinations 自身的 chat completions 端点模型为openai/gpt-6-luna强制response_format: json_object对传输/解析错误做最多 3 次指数退避重试见 operations/github/project_manager.py端点与模型常量在 L40-L41。PR 的额外事实classify()会拉取 PR 改动文件最多列 300 个与被关闭关联 Issue 的类型作为提示喂给分类器并要求以 PR 实际范围为最终依据见 operations/github/project_manager.py。字段校验classification_answer()校验area必须属于简报中的领域名、type属于允许集、priority属于允许集非法即ValueErrorarea为null时type/priority归零见 operations/github/project_manager.py。写入 Dev 项目通过 GitHub GraphQL 先addProjectV2ItemById加入 Dev 项目DEV_PROJECT_ID PVT_kwDOBS76fs4AwCAM再逐个updateProjectV2ItemFieldValue设置Area/Source/Priority/Work typeNone值走clearProjectV2ItemFieldValue见 operations/github/project_manager.py。字段必须与简报一致dev_fields()拉取 Dev 项目的单选字段选项并逐一对齐简报里的Area/Priority/SourcePR 再加Work type发现缺项就fail()退出——从机制上保证代码里的领域清单与Dev 项目的领域选项不漂移见 operations/github/project_manager.py。Source 维度item_source()按恰好一个来源的优先级判定——先APP-SUBMISSION→Apps、POLLEN-QUEST→Quests含 PR 关联的 Issue 标签否则按作者团队账号TEAM_IDS→Team、Bot 账号→Agent、其余→Community被 Discord relay 代发正文以**Author:** … (UID: …)结尾的不算 Agent见 operations/github/project_manager.py。保留人工优先级current_priority()会读该 Issue 在 Dev 项目上已有的 Priority若已被人工/早先运行/Express 作业设置则不覆盖见 operations/github/project_manager.py 与 L394-L396。APP-SUBMISSION特例带该标签的 Issue 直接判为App catalog showcase不再走 AI见 operations/github/project_manager.py。DRY_RUNDRY_RUN1时只打印将发生的变更、不写 GitHub用于人工派发的安全预演见 operations/github/project_manager.py 与 L379-L397。联动下游若设置了CLASSIFICATION_OUTPUT主流程结束前会把{area, type, source}写成 JSON 供gist 管线复用同一份分类结果见 operations/github/project_manager.py。4.3 触发与编排repo-organize-issues-prs.yml分类不是常驻进程而是由 CI 触发。.github/workflows/repo-organize-issues-prs.yml 的要点事件issues: opened / labeled、pull_request_target: opened其中labeled仅在新增APP-SUBMISSION或POLLEN-QUEST时才处理因为标签只会改变Source。幂等concurrency.group: project-manager-number、cancel-in-progress: false避免同一工作项并发写入。凭据用actions/create-github-app-token为pollinationsowner 临时签发 App Token作为GITHUB_TOKEN另注入POLLINATIONS_TOKENPLN_GITHUB_POLLY_KEY。常规路径python operations/github/project_manager.py见 workflow。回填路径workflow_dispatch可输入pr_numbers/issue_numbers空格分隔都不填则默认全部 open PR逐个用gh api组出GITHUB_EVENT再调用同一脚本dry_run默认开便于批量重分类存量覆盖 Area/Source/类型、仅在为空时填 Priority见 workflow。4.4 Express 优先级express_priority.py分类给出的 Priority 只有 High/Medium/LowExpress由独立的 operations/github/express_priority.py 稍后搬运。它每 30 分钟cron*/30 * * * *运行一次见 .github/workflows/repo-express-priority.yml逻辑见 operations/github/express_priority.py从 Tinybirdpaid_customers取付费客户的 GitHub ID只处理近SINCE_HOURS默认 2小时内新建、Source Community、且已有 Priority非空、非 Express的 Issue命中者把 Dev 项目上的 Priority 提升到Express团队自建、census 作答、app submission 一律不动。这正是简报里Express由另一个作业搬运、机器人自己永不选 Express的具体实现也是 4.2 中已设置优先级不覆盖的下游受益者。4.5 测试佐证test_project_manager.pyoperations/github/test_project_manager.py 用单元测试固化了分类的边界行为可作为实现事实的交叉验证PR 的type不允许带 issue 的 Prioritytest_pr_type_has_no_issue_priorityIssue 的Question类型与 Priority 仍受支持test_native_issue_question_and_priority_remain_supportedarea为None的工作不产生 type/prioritytest_unclassified_work_does_not_get_type_or_priority关联 Issue 的类型确实进入分类器 prompt且包含改动文件与hints, verify against PR scope字样test_linked_issue_type_reaches_classifier_promptpromote/sync 类 PRareaNone会把已有Work type清空、且不调用原生set_issue_typetest_promotion_pr_clears_existing_work_type_through_main拉取关联 Issue 失败时closing_issues()会失败且不被缓存test_missing_linked_issue_node_fails_and_is_not_cached。五、与根 AGENTS.md 的约定衔接issue-maker 的几条准则其实都是根 AGENTS.md 更宽约的可执行投影理解这些衔接能避免 Agent 犯错app-submission 状态机技能说根AGENTS.md定义 app-submission 状态即 AGENTS.md 中APP-SUBMISSION持久类型标签→APP-NEEDS-INFO/APP-REVIEW评审状态→APP-APPROVED维护者加的两阶段评审真源为operations/app-management/app.json由apps-review-submissions.yml与apps-publish-submissions.yml驱动。技能准则 2.3 里的不拿不准就查仓库上下文在此即指向该状态机。标签纪律技能不要为 area/type/priority 加标签与 AGENTS.md Labels are only for workflows … and goals (REVENUE); dont repurpose them or create new labels ad hoc 完全对应——标签是工作流/目标专用分类维度走 Dev 项目字段。沟通风格技能的短标题 ≤3 要点 链接相关 直接返回摘要对应 AGENTS.md 的 Communication Style要点化、200 词、事实非观点、链接代码、直接。贡献归属与 Issue 关联的 PR 用Fixes #issue/Addresses #issue社区贡献用Co-authored-by: {username} {user_id}{username}users.noreply.github.com数字 user ID 来自 issue API由访问请求 Issue 触发的 publisher-allowlist PR还要把请求者加为Co-authored-by见 AGENTS.md 的Contributor Attribution。六、适用边界与小结适用前提本技能面向pollinations/pollinations仓库的 Issue/PR 工作记录其自动分类依赖仓库内已部署的project_manager.py Dev 项目PVT_kwDOBS76fs4AwCAM 相关 CI。若你只是登记一件事技能只要求你去重、按格式建 Issue、按 ownership 表指派、返回链接并不要落地本地文件、不要替机器人加分类标签。一句话总结issue-maker 把如何写一条合规的 Issue收敛成 5 条可执行准则 一张 ownership 表而分类归谁管的问题则交给project-manager.md单一事实来源与project_manager.py机器人、repo-organize-issues-prs.yml触发器、express_priority.py提升作业这条自动化管线——技能负责正确地记录机器人负责正确地归档两者边界清晰、互为依据。赞分享AI 应用媒体生成后端前端【免费下载链接】pollinationsYour Friendly Open-Source Gen-AI Platform项目地址https://gitcode.com/gh_mirrors/po/pollinations点击查看免费下载相关推荐Mac Mouse Fix vs Logitech OptionsMac 鼠标增强完整选型3 个问题 3 分钟选对Mac Mouse Fix vs Logitech OptionsMac 鼠标增强完整选型3 个问题 3 分钟选对 赶 deadline 前 10 分钟你桌面应用系统编程Ant Design Issue 回复技能issue-reply详解面向维护者与 AI Agent 的 Issue 处理规范及仓库自动化佐证Ant Design Issue 回复技能issue reply详解面向维护者与 AI Agent 的 Issue 处理规范及仓库自动化佐证 本篇基于 A前端UI组件设计系统Gentle AI issue-creation 技能深度解析基于证据的 GitHub Issue 创建、分类与受控发布契约Gentle AI issue creation 技能深度解析基于证据的 GitHub Issue 创建、分类与受控发布契约 本文档是 Gentle AI上一篇Cloudflare Skills安全实战密钥管理、最小权限原则与防爬令牌验证下一篇如何把你的科研工作流打包成Science Skills技能workflow-skill-creator五阶段蒸馏法全解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
