使用说明

🚀 Gigaspec

AI原生规范框架

AI进行思考。我们提供结构。

安装 • 快速开始 • 文档 • GitHub

🎯 什么是Gigaspec？

Gigaspec是一个 AI原生协作框架 这改变了软件项目的规划和构建方式。Gigaspec支持静态模板或基于关键字的推荐，而不是 深度人工智能分析 通过智能问答工作流程满足您的需求。

传统工具的问题

User: "I want to build a real-time collaborative app"
Traditional Tool: "Use Elixir!" ← No questions, no reasoning

Gigaspec之路

User: "I want to build a real-time collaborative app"
AI: "Tell me more! What's your expected user count? Do you need 
     offline support? What's your team's expertise?"
     
     → Analyzes deeply
     → Explains reasoning  
     → Recommends tailored stack

✨ 特性

特性	描述
🚀 Gigaspec V 5.0	终极规格套件强制人工智能合规
🔒 不可变规则	CLAUDE.md强制执行AI无法覆盖的标准
✅ 自动验证	每个代码更改在完成之前都经过验证
🛠️ 通用工具支持	Claude代码、游标、Kimi适配器
🌍 模型不可知	与Claude、GPT、Gemini、Llama合作
🤖 AI原生工作流	专为AI助手设计，以推动开发
💬 智能问答	AI问的是澄清问题，而不是关键字匹配
📋 生活文档	STATE.md跟踪进度，AGENT.md指导AI编码
🎯 堆栈建议	深入分析，透明推理
🔧 MCP服务器	与AI IDE的原生集成
📦 零配置	使用合理的默认值即可开箱即用

🚀 快速开始

安装

# Global installation
npm install -g gigaspec

# Or use without installing
npx gigaspec init --name "MyApp"

创建您的第一个项目

# Interactive AI-guided wizard
gigaspec init

# Or specify your stack directly
gigaspec init --name "MyApp" --stack "Node.js/Next.js"

# Non-interactive with defaults
gigaspec init --name "MyApp" --yes

# Generate v5.0 Ultimate Spec Kit (RECOMMENDED)
gigaspec generate --name "MyApp" --stack "Node.js/Express" --v5

🚀 Gigaspec v5.0（终极规格套件）

强制AI合规的规范框架。

# Generate v5.0 spec kit with immutable rules
gigaspec generate --name "MyApp" --stack "Node.js/Express" --v5

是什么让v5.0与众不同：

CLAUDE.md -不可变系统规则AI 不能以（权力）否决
自动验证 -每次代码更改都经过验证
多工具适配器 -Claude Code、Cursor、Kimi支持
模型不可知 -适用于任何法学硕士

生成的v5.0结构：

my-project/
├── CLAUDE.md          ← IMMUTABLE system rules (AI cannot override)
├── AGENT.md           ← Project-specific standards
├── STATE.md           ← Living project status
├── ARCHITECTURE.md    ← System design
├── PLAN.md            ← Development roadmap
├── RULES/             ← Modular rule modules
│   ├── security.md
│   └── testing.md
├── .claude/           ← Claude Code adapter
│   ├── CLAUDE.md
│   ├── skills/
│   └── agents/
├── .cursorrules       ← Cursor IDE adapter
├── .cursor/
│   └── agents/
└── .kimi/             ← Kimi CLI adapter
    └── AGENT.md

创建内容（v4.x）

my-project/
├── AGENT.md           ← AI coding standards & constraints
├── ARCHITECTURE.md    ← System design & decisions  
├── PLAN.md            ← Development roadmap
├── STATE.md           ← Project status (living document)
├── WORKFLOW.md        ← AI development protocols
├── SETUP.md           ← Local development guide
├── DEPLOYMENT.md      ← Production deployment
├── ENVIRONMENT.md     ← Secrets & configuration
├── CLAUDE.md          ← Claude Code integration guide
├── .cursorrules       ← Cursor IDE rules
├── .github/workflows/ ← CI/CD automation
├── .hooks/            ← Git hooks
├── scripts/           ← Utility scripts
└── prompts/           ← AI prompt templates

🤖 AI助理

Gigaspec既可以作为 CLI工具 （对于人类）和 MCP服务器 （适用于AI IDE）。使用适合您工作流程的选项：

命令行界面：运行 gigaspec 直接在终端中执行命令
主控程序：AI助手通过MCP集成使用工具

支持所有CLI命令 --json 对于结构化输出：

# Start AI workflow
gigaspec init --json

# Get current task to implement  
gigaspec continue --json

# Verify code compliance
gigaspec verify --json

MCP集成

Gigaspec包括一个用于Kimi、Claude Desktop和Cline等AI IDE的MCP（模型上下文协议）服务器。

配置

添加到AI IDE的MCP设置中：

选项1：全局安装（推荐）

npm install -g gigaspec

然后配置您的AI IDE：

Kimi桌面 (~/.kimi/mcp.json):

{
  "mcpServers": {
    "gigaspec": {
      "command": "gigaspec-mcp"
    }
  }
}

克劳德桌面 (%APPDATA%/Claude/claude_desktop_config.json 在Windows上）：

{
  "mcpServers": {
    "gigaspec": {
      "command": "gigaspec-mcp"
    }
  }
}

选项2：使用npx（无需安装）

{
  "mcpServers": {
    "gigaspec": {
      "command": "npx",
      "args": ["-y", "gigaspec-mcp"]
    }
  }
}

方案3：地方发展（项目路径）

在开发gigaspec本身或使用本地副本时：

{
  "mcpServers": {
    "gigaspec": {
      "command": "node",
      "args": [
        "./bin/mcp-server.js"
      ],
      "env": {}
    }
  }
}

可用工具

配置后，您的AI助手可以使用：

gigaspec-init --初始化项目
gigaspec-analyze --创建分析提示
gigaspec-generate --生成规范文件
gigaspec-status --获取项目状态
gigaspec-wizard --交互式项目设置

📚 命令

核心命令

命令	描述
`gigaspec init`	使用AI协作框架初始化项目
`gigaspec analyze "<description>"`	为AI创建分析提示
`gigaspec generate`	生成规范文件
`gigaspec status`	显示当前项目状态
`gigaspec continue`	获取下一个开发任务
`gigaspec verify`	根据AGENT.md验证代码

选项

# JSON output for AI consumption
gigaspec init --name "MyApp" --json

# Specify stack
gigaspec init --name "MyApp" --stack "Elixir/Phoenix"

# With all options
gigaspec init \
  --name "MyApp" \
  --stack "Node.js/Express" \
  --database "PostgreSQL" \
  --deploy "Railway" \
  --yes

🎓 运作原理

1.描述你的项目

"I want to build a math learning app for kids"

2.AI深度分析

AI收到一个结构化的提示，并：

✅ 分析核心需求
✅ 识别用户类型和规模
✅ 考虑技术挑战
✅ 提出澄清问题

3.智能问答

AI: "I have some questions to better understand your needs:

1. What age range are you targeting?
2. Do you need offline capability?  
3. Will this be free or subscription?
4. Any compliance requirements (COPPA)?"

4.量身定制的建议

AI: "Based on your answers, I recommend:

Stack: Next.js 14 with PWA capabilities
Why: PWA gives offline capability, Next.js excels at interactive content

Database: PostgreSQL via Supabase  
Why: Built-in realtime for progress sync, COPPA compliance features

Services: Clerk (COPPA-compliant auth), Stripe (payments)"

5.生成和构建

gigaspec generate --stack "Next.js 14" --name "MathLearn"

🆚 比较

	传统工具	Gigaspec
分析	关键词匹配	深度AI推理
问题	无	智能问答
解释	“使用X”	“因为Y而使用X”
定制的	一刀切	项目特定
AI工作流程	不是为AI设计的	为AI协作而构建的

📁 项目结构

当你奔跑时 gigaspec init，您将获得一个完整的规范框架：

📦 my-project/
├── 📄 AGENT.md              AI coding standards (the "rulebook")
├── 📄 ARCHITECTURE.md       System design & tech decisions
├── 📄 PLAN.md               Development phases & milestones
├── 📄 STATE.md              Current status & next tasks
├── 📄 WORKFLOW.md           AI collaboration protocols
├── 📄 SETUP.md              Environment setup guide
├── 📄 DEPLOYMENT.md         Production deployment
├── 📄 ENVIRONMENT.md        Secrets & configuration
├── 📄 CLAUDE.md             Claude Code integration
├── ⚙️  .cursorrules          Cursor IDE rules
├── 🗂️  .github/workflows/    CI/CD automation
├── 🗂️  .hooks/               Git hooks
├── 🗂️  scripts/              Utility scripts
└── 🗂️  prompts/              AI prompt templates

🧪 示例演练

看示例.md 了解构建数学学习应用程序的完整演练，包括：

初始项目描述
AI分析和问题
将推荐与推理叠加
全规格生成
开发工作流程

🔧 需求

Node.js >= 16.0.0
npm 或纱线

📄 许可证

Apache许可证2.0——请参阅许可证文件以获取详细信息。

由...制作❤️ 用于人工智能与人类的协作

⭐ 在GitHub上为我们投票 • 🐛 报告问题