获取 Core

免费 · 本地 · 开放

一次安装。
激活。
写更好的 代码。

Specability Core 是免费的本地 coding-agent harness。一个文件，无云依赖，无自动上传。装好、接入你的 agent，直接开工。

安装 · 第一步

一条命令，任何平台。

Specability Core 是一个静态二进制文件。选适合你的渠道——装的都是同一个东西。安装之后，继续第二步将 Core 接入你的 agent——只安装不会让它在 agent 会话中生效。

npm
npm install -g specability
Homebrew (macOS / Linux)
brew tap SpecabilityAI/tap && brew install specability
shell 脚本 (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/SpecabilityAI/specability-core/main/install.sh | sh
PowerShell (Windows)
irm https://raw.githubusercontent.com/SpecabilityAI/specability-core/main/install.ps1 | iex

激活 · 第二步

把 harness 接入你的 agent。

Core 仅通过一个会话启动 hook 集成——不会向你的宿主工具目录写入 skill 文件、agent 定义或 spec 文件。跳过这步，Core 虽已安装但在你的 agent 会话中不会生效。

  1. 一

    注册 hook

    选择你使用的 agent。hook 在会话启动时触发，自动加载项目上下文。

    specability install hook --host claude --scope global   # Claude Code
specability install hook --host codex  --scope global   # Codex CLI
specability install hook --host gemini --scope global   # Gemini CLI
  2. 二

    开启新会话

    注册 hook 后，启动一个全新的 agent 会话——hook 只在会话启动时触发，已有会话不会生效。首次运行时，你的 agent 宿主可能会弹出权限确认，询问是否允许 hook 执行：直接批准，这就是 Core 接入的那一步。之后 hook 会自动注入项目上下文、方法论指引和运行时状态。

  3. 三

    限定到项目（可选）

    使用 --scope project 代替 --scope global，仅为单一项目激活 Core。适合你想在部分仓库中使用 harness、但不是全部的场景。

    cd your-project
specability install hook --host claude --scope project

验证 · 第三步

确认安装和激活均成功。

specability doctor

Core 的位置

三层，其中一层负责执行。

技能框架塑造 agent 的工作方式。规格工具对齐 agent 要建什么。Core 是执行层——判断 agent 是否真的做了的那一层。

  1. 技能框架

    代表：Superpowers

    将方法论作为技能文件在会话启动时注入，在任何工作开始前塑造 agent 的流程、角色和思维方式。

    Agent 读了技能。它是否真的照做——工作是否真的完成——没有运行时强制。

  2. 规格工具

    代表：OpenSpec

    在写代码前先定义要建什么，用结构化规格文件对齐人和 agent 的需求。

    Spec 说了要建什么。Agent 是否真的建了、能否证明——这超出了规格层的范围。

  3. 流程 harness

    Specability Core

    在运行时强制执行流程，以证据为门槛关闭完成状态，将每一项任务、决策、检查与结果写入持久可检索的记录。

你的第一个会话

开启一个会话，harness 接管其余的一切。

激活之后，每次新的 agent 会话都从 Core 的结构化定向开始。agent 知道项目、方法论，以及在说"完成"之前需要验证什么。你描述任务——harness 把控流程。

  1. 一

    会话启动时的结构化上下文

    hook 触发一次。你的 agent 自动接收项目地图、活跃任务状态、方法论指针和 runtime 上下文——无需手动说明。

  2. 二

    agent 发现并文档化代码库

    如果模块文档不存在，agent 会自动引导生成——为每个模块创建声明目的、原则和边界的结构化文档。CLI 验证结构并将其与运行代码核对。

  3. 三

    agent 在约束下工作

    明确的角色分工。强制的证据检查。边界合规由 harness 执行。agent 不能仅凭自述就将工作标记为完成——证据必须留有记录，harness 会读取记录。

  4. 四

    你无需索取就能得到记录

    每一项任务、决策、检查与结果都写入持久、可检索的记录中。当某个决策日后被质疑，答案——以及它所依据的规则——早已在案。

源码

开放构建，公开更新日志。

每个版本都发布签名二进制、SHA-256 校验和与发布说明。公开仓库托管安装脚本、npm 安装器和 Homebrew formula。提 issue、阅读更新日志、验证构建——全部公开透明。

GitHub → SpecabilityAI/specability-core
← harness 工作原理发起合作 →