跳到主要内容

每个编码智能体都能读懂。

SpecWeave 不需要服务，也不需要账号。编码智能体直接读取你仓库里的文件，所以 Claude Code、Codex、Grok 等都能接上同一份规格和台账。

示意图 · 每个智能体都读取你仓库里的同一批文件

编码智能体

每个工具里的 CLI 都一样，所以没有技能的工具也能跑通整个流程。在它们之间切换，或在同一工具的两个订阅之间切换，就是一次交接加接手。更多内容见Codex、Grok 及其他智能体。

  • Claude Code，包括 Projects 线程

    读取
    CLAUDE.md，它会导入 AGENTS.md
    技能
    .claude/skills/

  • Codex

    读取
    AGENTS.md
    技能
    .agents/skills/

  • Grok Build

    读取
    AGENTS.md 和 CLAUDE.md
    技能
    .grok/skills/、.agents/skills/、Claude Code 技能

  • Cursor, GitHub Copilot, Gemini CLI, OpenCode

    读取
    AGENTS.md
    技能
    各自的文件夹，或直接使用 CLI

议题跟踪器（可选）

推送属于对外写入，因此只在你运行时才会发生。开始、暂停或恢复增量绝不会碰跟踪器，除了推送，也没有任何操作会创建议题。仅当开启“完成时关闭”设置时，完成增量才会关闭推送所关联的议题；sync setup会开启它，你也可以关闭。sync pull会报告跟踪器中发生了什么变化，供你审阅；它不会改写你的本地文件。

specweave sync setup           # 连接跟踪器
specweave sync status          # 凭据、健康状况、将发生的变更
specweave sync push 0042       # 按你的选择发布进度
specweave sync pull            # 报告在跟踪器中所做的变更

谁负责什么

议题被关闭，并不代表验收标准已通过；通过的验证报告才算数。

在你的仓库里

规格与台账

规格和台账记录了“完成”意味着什么，以及验证了什么。

在跟踪器里

规划上下文

跟踪器保存规划上下文：优先级、负责人、标签，以及相关方查看进度的地方。

我需要跟踪器吗？

不需要。规格、台账、交接和仪表板都能在本地使用。需要让协作更顺畅时再加跟踪器。

在仪表板上移动卡片会更新 Jira 吗？

不会。看板变更只在本地。想更新跟踪器时，对该增量运行 specweave sync push。

团队应该如何评估？

先用一个仓库和一个临时的跟踪器项目。连接真正的跟踪器之前，用 sync push --dry-run 检查映射、权限、重新打开的议题和部分失败的情况。

SpecWeave 的其他产品

Jev (System One)

用一个小而快的模型回答封闭集合的决策问题。

Verified Skill

经过安全检查的智能体技能注册表，用 npx vskill 安装。

specweave sync 参考

跟踪器同步命令，集中在一个参考页面。