@jaggerxtrm/pi-extensions

AI代理工作流系统,规范编码流程

开发流程 协调多智能体同步项目上下文拆解开发任务审查AI生成代码 claude通用 ★ 1 更新于 2026-09-13

安装使用

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

帮我安装这个 AI Skill:@jaggerxtrm/pi-extensions。
它的用途是:AI代理工作流系统,规范编码流程
完整的 Skill 内容见:https://321skill.com/skills/jaggerxtrm-pi-extensions/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'使用XTRM-Tools初始化当前项目,创建一个新的issue来重构用户认证模块,并声明由我来处理。' 它会运行`xtrm init`配置环境,然后通过`bd create`创建issue,再执行`bd update 1 --claim`声明任务。之后所有代码修改都必须先通过编辑门控验证,提交前必须关闭issue,确保流程规范。

介绍

这个Skill解决了AI编码代理在开发过程中缺乏结构化流程的问题。在实际开发中,开发者经常遇到AI代理随意修改代码、忘记跟踪任务、提交不规范等情况,导致项目混乱、上下文丢失。XTRM-Tools通过Beads(Dolt-backed issue跟踪)、Hooks(自动执行门控)和Skills(可复用行为库)将Claude Code和Pi转变为自律、自管理的开发代理,确保每个会话都有结构、每次变更都可追踪。

使用方式很简单,你只需要在项目中运行xtrm init初始化,系统会自动配置Beads issue跟踪、Hooks门控规则和Skills库。之后就可以通过自然语言指令来管理开发流程:使用bd ready领取任务,bd update <id> --claim声明编辑,bd close <id>关闭任务后自动允许提交。Hooks会在后台自动执行:编辑门控阻止无声明的写入,提交门控强制关闭issue后才能git commit,停止门控检查未完成工作,记忆门控在退出前提示持久化洞察。质量门控还会在保存文件时自动运行ESLint、tsc、ruff、mypy等检查。

它非常适合需要规范化AI编码流程的团队或个人。尤其是那些已经使用Claude Code或Pi进行日常开发,但希望避免AI代理随意操作、确保代码质量和任务可追溯的团队。也适合需要跨会话保持上下文、多人协作的AI辅助开发场景。Planning技能可以从任何需求生成结构化issue板,支持跨会话继续工作。Statusline实时显示当前声明、开放issue数、模型、上下文窗口健康度等。

建议在团队统一使用此工具时,先通过xtrm init初始化并配置好Hooks规则。需要注意的是,它主要依赖Dolt数据库进行issue跟踪,需要确保Dolt服务可用。同时,Hooks的自动门控可能会在初期让开发者感到约束,但这是为了培养良好的开发习惯。Specialists功能在v0.7.19版本中成为一等公民,建议升级到最新版本以获得完整功能。

常见问题

如何安装XTRM-Tools?

通过npm安装:`npm install @jaggerxtrm/pi-extensions`,然后在项目中运行`xtrm init`初始化。

XTRM-Tools支持哪些AI编码工具?

目前支持Claude Code和Pi两个平台,所有技能和门控规则在两个平台上行为一致。

给 AI 助手的安装指引

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

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