这个项目能做什么
Specrails Core 是一个基于 Node.js 的 CLI 和代理工作流框架,用于基于规范的软件开发。它将基础角色——架构师、开发者和审阅者——安装到项目中,并为 Claude Code、Codex CLI、Gemini CLI 和 Kimi Code 提供原生命令。预期流程为:规范 → 架构 → 实现 → 审阅 → 交付;架构师生成 OpenSpec 提案、设计和任务,开发者执行同意的工作,审阅者根据规范和项目验证命令检查结果。
从项目安装:npx specrails-core@latest init --provider claude(选择 claude、codex、gemini 或 kimi)。非交互式:npx specrails-core@latest init --yes --provider claude。提供商使用原生命令,例如 /specrails:implement、$implement 和 /skill:specrails-implement。Kimi 集成针对 Kimi Code 0.27.0+,并使用 .kimi-code/specrails/run-skill.mjs 进行无头激活。Core 5 直接安装角色和工作流,而不会为丰富阶段调用模型。
安装的表面包括提供商目录(.claude、.codex、.gemini、.kimi-code)、openspec/ 规范和变更产物、.specrails/config.yaml 和 install-config.yaml、.specrails/rules/ 和 agent-memory/、.specrails/runtime/ 和 pipeline/、可选的 .specrails/local-tickets.json 以及 .specrails/profiles/。独立安装通常将可提交的产物复制到仓库中,并使用位于 ~/.specrails/ 的共享框架存储;重新定位或由桌面管理的空间可以将框架链接和项目产物放在检出之外。托管文件可以由更新重新生成;用户扩展应使用文档化的路径,例如 .specrails/profiles/** 和 custom-* 角色。
更新与刷新可执行文件是分开的:npx specrails-core@latest update --dry-run、update、doctor。现有提供商选择由当前更新实现保留;当前源拒绝较旧的 CLI 覆盖较新的已安装框架。从 Core 4 迁移将移除 enrich 命令、快速/完整安装层以及捆绑的非核心专家代理;自定义代理应移动到受保护的 custom-* 角色,并更新配置文件引用。
包含一个可选的程序化代理运行时:一个具有每角色提供商、持久恢复和本地 OpenAI 兼容模型的共享 LangGraph 工作流,通过 TypeScript API 和 CLI 暴露。独立自动交付可以在启用时创建分支、提交、推送和拉取请求;GitHub 拉取请求需要经过身份验证的 gh CLI。主机(例如 Specrails Desktop)可以设置 SPECRAILS_GIT_AUTO=false,并拥有工作树和交付。多仓库上下文必须显式识别选定的仓库和 OpenSpec/积压工作所有者。
配置、规范和运行状态是本地文件,但提供商 CLI 会将提供的上下文发送到配置的模型服务,并且包安装、GitHub/Jira 和 MCP 集成可能会使用网络。模型使用由提供商计费。该项目采用 MIT 许可证,需要 Node.js 20.19.0+ 带有 Git,并至少有一个经过身份验证的 AI CLI;从源代码开发使用 npm ci、npm test、npm run build、typecheck 和 coverage 命令。
评论
0 评分人数达到10人后显示
登录后参与讨论。