@abelxiaoxing/cadence

Four explicit Abel workflow prompts with stage-isolated design and diagnosis, durable resumable implementation, and three package-owned professional Agents.

Packages

Package details

extensionskillprompt

Install @abelxiaoxing/cadence from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@abelxiaoxing/cadence
Package
@abelxiaoxing/cadence
Version
1.8.3
Published
Sep 21, 2026
Downloads
4,807/mo · 749/wk
Author
abelxiaoxing
License
MIT
Types
extension, skill, prompt
Size
1.6 MB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "skills": [
    "./skills"
  ],
  "prompts": [
    "./prompts/*.md"
  ],
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@abelxiaoxing/cadence

面向 Pi 的 Abel 工作流扩展：提供 Design、Implement、Diagnose 和 Init 四个显式命令。 普通任务无需启用工作流；只有用户主动输入斜杠命令时才会激活。

安装

要求：Node.js >= 22.13、Git、Pi，以及 @fission-ai/openspec@1.5.0。

pi install npm:@abelxiaoxing/cadence

使用

/abel-init
/abel-design <需求>
/abel-implement <change>
/abel-diagnose <问题描述>
  • abel-init：初始化或修复项目的 OpenSpec 与 AGENTS 基础结构。
  • abel-design：调查需求并生成可执行交付计划。
  • abel-implement：执行已批准的计划，支持暂停、恢复和取消。
  • abel-diagnose：复现问题并执行最小修复。

Implement 默认使用 Linux Bubblewrap 隔离。

可信 Linux 项目可显式设置 ABEL_EXECUTION_MODE=local-trusted。

Windows x64 的可信模式见 Windows 执行说明。

配置

没有自定义路由时，Worker 默认继承当前父模型。

需要自定义模型时，复制 config/routes.example.json 到项目的 .pi/cadence/routes.json 或用户目录 ~/.pi/agent/cadence/routes.json。

研究服务配置使用项目级 .pi/cadence/.env 或用户级 ~/.pi/agent/cadence/.env。

可参考 config/.env.example。

密钥只保存在本地，不要提交 Git。

加载方式

包可以从以下路径加载：

  • npm 包（npm package）：pi install npm:@abelxiaoxing/cadence
  • 本地包目录（local package directory）：将 Pi 指向仓库的绝对或相对路径（例如 ./cadence）
  • 已安装 tarball 目录（installed tarball directory）：用 bun pm pack --destination <tmp> 生成 .tgz，安装或解压后指向该目录

Pi 相关 peer 依赖使用 *，不限制宿主 Pi 的版本。

开发

bun install
bun run check       # 语法、构建产物和类型检查
bun run lint        # 格式与 Markdown 检查
bun run test        # 测试
bun run verify      # 发布前完整检查

其他只读检查：

bun run doctor /path/to/project
bun run runs /path/to/project
bun run pack:check
bun run traceability:check

附录

公共 UI 的 impactClosure 作者格式

page-state 与 public-html 可以同时声明。 以下是 PlanDraft 任务片段，合并到现有 tasks[i]；路径和证据必须替换为仓库真实调查结果。 假设 Red 修改 test/page-state.mjs，已有 test/public-html.mjs 只读保留：

{
  "read": ["test/page-state.mjs", "test/public-html.mjs"],
  "impactClosure": {
    "changedSurfaces": ["page-state", "public-html"],
    "searchEvidence": [
      "检索页面状态的调用点及 test/、tests/ 中的覆盖：test/page-state.mjs 需更新状态切换断言，test/public-html.mjs 覆盖现有公开 HTML。"
    ],
    "relatedTests": [
      {
        "path": "test/page-state.mjs",
        "evidence": "本任务 Red 更新页面状态切换回归；由阶段 write 推导为 current-task。"
      },
      {
        "path": "test/public-html.mjs",
        "evidence": "保留已有 HTML 断言并执行受影响验证；无任务写入，推导为 unaffected。"
      }
    ],
    "affectedSuite": ["test/page-state.mjs", "test/public-html.mjs"]
  }
}

impactClosure 恰好包含 changedSurfaces、searchEvidence、relatedTests 和 affectedSuite 四个字段。 changedSurfaces 是合法枚举数组，none 不能与其他值混用。 searchEvidence 记录实际检索与结论。 relatedTests 每项位于 test/ 或 tests/ 下，disposition 可省略由编译器推导。 affectedSuite 是影响清单而非验证器，每项必须有对应的 relatedTests 条目。

项目结构

  • src/：扩展和工作流实现
  • prompts/：四个用户入口
  • agents/、skills/：随包资源
  • config/：示例配置
  • openspec/specs/：当前规范
  • docs/：仅保留必要的平台说明
  • README.md 附录：公共 UI 计划的 impactClosure 作者格式

历史设计、评估报告和已完成变更不放在主仓库中。

许可

MIT，详见 LICENSE 和 THIRD_PARTY_NOTICES.md。