工具
Speck v1.0 发布:用规格文件驱动 AI 智能体管理
Speck v1.0 是一款受编译器启发的规格驱动 AI 智能体工具,通过三层架构实现代码与规格的双向同步。
2026.07.05 · 周日约 2 分钟阅读
Speck 是一款面向开发者的 AI 智能体管理工具,其设计灵感来源于编译器与构建工具的理念,将「规格驱动开发」引入 AI 代码生成流程。该项目已在 crates.io 发布 v1.0 版本,基于 zerostack 运行,需要环境中已安装可用的 zerostack 二进制文件。
核心架构:三层分离
Speck 采用三层目录结构来组织项目信息:
- specs/features/:定义「做什么」,即功能层面的需求规格;
- specs/technical/:定义「怎么做」,即技术实现层面的规格;
- src/:实际的代码实现层。
用户在任意一层进行编辑,Speck 都会通过 BLAKE3 哈希检测变更,并由专门的 AI 提示将改动同步到其他两层,实现双向同步。
主要功能
- 迁移能力:
speck migrate可从任意已有代码库逆向生成 specs/technical/,并进一步推导 specs/features/,便于为遗留项目补全规格文档。 - 项目脚手架:
speck init会生成标准的 AGENTS.md、ARCHITECTURE.md 与提示词模板,作为新项目的起点。 - 冲突解决:当代码与规格同时被修改时,Speck 会提示用户选择优先级,也可通过
--prefer-code或--prefer-specs标记自动决策。 - 代码审查:
speck review调用专门的提示词执行结构化审查,并以 Markdown 报告形式输出结果。 - Git 集成:
speck git-hooks可一键安装 pre-commit、pre-push、post-merge、post-checkout 等钩子,自动触发同步、格式化或状态检查。
定位与局限
Speck 的目标是替代传统的对话式交互,把 AI 代码生成纳入可复现、可验证的工程流程中,让规格而非聊天记录成为管理智能体的核心载体。不过该项目目前在 Hacker News 上仅获得 1 个点赞、0 条评论,社区关注度极低,生态成熟度与下游采用情况仍有待观察。开发者可访问 crates.io 上的 speck-dev 页面获取安装与使用方式。
