isq

一个统一的离线优先命令行工具,用于管理GitHub、Linear和JIRA问题。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:isq。
它的用途是:一个统一的离线优先命令行工具,用于管理GitHub、Linear和JIRA问题。
完整的 Skill 内容见:https://321skill.com/skills/isq/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我列出当前项目中所有分配给我的、状态为open的bug类issue。',它会调用isq执行类似 `isq issue list --mine --label=bug --state=open` 的命令,从本地缓存中瞬间返回结果。或者,你可以说:'基于当前分支的修改,创建一个新的issue,标题是修复登录超时问题。',AI会利用isq的Git集成能力,创建issue并自动关联上下文。

介绍

isq 解决了开发者因切换不同问题追踪平台(如GitHub、Linear、JIRA)而被迫改变工作流程的痛点。它将所有问题数据缓存在本地,提供亚毫秒级的读取速度,并允许用户通过一套统一的CLI命令与多个平台交互,实现离线工作、在线同步。

使用上,首先通过 isq link 命令将本地仓库链接到目标平台(如GitHub、Linear或JIRA)。之后,即可使用 isq issue listisq issue create 等命令快速查看、创建、编辑问题。所有操作默认优先从本地缓存读取,速度极快,并支持JSON输出以便与其他工具集成。

它非常适合需要频繁与多个问题追踪系统打交道,或希望将工作流程与特定平台解耦的开发者。无论是前端、后端还是全栈开发者,只要使用Git进行版本控制并管理项目任务,都能从中受益。

建议初次使用时,先通过 isq link 链接一个常用项目,体验其离线查询的流畅性。注意,该工具目前仅支持macOS和Linux系统,且主要面向命令行熟练用户。对于依赖图形界面或Windows环境的用户,可能需要寻找替代方案。

核心特点

与单一平台CLI工具不同,isq实现了跨平台(GitHub、Linear、JIRA)的问题管理统一入口;其离线优先架构和本地Git工作树集成,确保了极速响应和开发环境与问题状态的深度绑定,这是其他在线API封装工具所不具备的。

注意事项

目前不支持Windows系统,且主要面向习惯使用命令行的技术人员,对图形界面用户不友好。

常见问题

安装后提示'command not found'怎么办?

可能是因为安装脚本将可执行文件放在了~/.local/bin目录,请将该路径添加到你的shell配置文件(如.bashrc或.zshrc)的PATH环境变量中。

如何让我的AI编码助手(如Cursor)使用isq?

可以使用命令 `npx skills add camwest/isq` 来为你的AI Agent安装此Skill,使其具备issue管理能力。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/isq/raw/index.md 读取 isq 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。