获取 Core

免费 · 本地 · 开放

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

Specability Core 是免费的本地 coding-agent harness。一个文件，无云依赖，也不会向 SpecabilityAI 自动上传数据。启用 host hook 后，定向上下文会传给你选择的 AI 宿主及其模型提供商。装好、接入你的 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 执行：批准后，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 元数据——不包含本地绝对路径或 memory claim 正文。只有显式提供任务 ID 时才会附带该任务的恢复上下文。

  2. 二

    agent 发现并文档化代码库

    当稳定模块需要持久定向信息时，agent 会创建并维护 README，说明模块角色、所有权、触点和变更指引，再注册其准确路径。CLI 只消费显式注册并执行机械检查；语义是否与代码一致仍由 agent 判断和协调。

  3. 三

    agent 在约束下工作

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

  4. 四

    你无需索取就能得到记录

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

源码

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

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

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