SuperAPI AI 工具集

setup-mana

通用与其它

查看项目

更新于 10-15 21:46

技能介绍

用途:setup-mana 用于为仓库做初始化设置,让其他技能能读取到统一配置。它使用用户选定的追踪器,写入后续技能读取的每仓库配置文件;当追踪器选择缺失时会询问工单存放在哪里。支持 GitHub Issues、Linear、Jira 以及 .scratch/ 下的本地 Markdown 文件。

主要能力与用法:执行流程分为检测、确定追踪器、写入、校验并报告四步。检测阶段只读取不假设,会查看 git remote、gh 仓库信息、CLAUDE.md 与 AGENTS.md、已有的 docs/agents/issue-tracker.md、认证状态、环境变量(如 LINEAR_API_KEY、JIRA_BASE_URL 等),以及最近提交中的工单号前缀。检测按固定顺序判断,一次只标记一个被检测到的追踪器,GitHub 放在最后,因为几乎每个仓库都有 GitHub 远程。

确定追踪器时会复用用户已给出的选择;仅当选择缺失或用户要求切换但未指定目标时才提问。写入阶段从对应模板生成 docs/agents/issue-tracker.md,按需生成 docs/agents/triage-labels.md,并把设置相关行合并进 CLAUDE.md 或 AGENTS.md 中的 ## Agent skills 块,保留其他行原样。校验阶段会读取团队或项目信息并列出标签,可创建标签或运行 bash "<SKILL_DIR>/scripts/tickets.sh" 的 check 与 ensure-labels 命令;本地与其他追踪器跳过该阶段。

适用场景与限制:适用于需要统一工单追踪配置、让其他技能共享追踪信息的仓库。秘密只以环境变量名出现,绝不写入值;未验证的配置会标注并指明需要设置的具体变量。本地文件追踪器不校验,仅提示 .scratch/ 是否被 gitignore。该技能不添加 persona 或 style 设置,不改动分支名模式等有默认值的事项。所有输出为普通 Markdown,可手工编辑,文件对新会话生效。