gigaspec (Oleksiitrembach)

🚀 Gigaspec

AI原生规范框架

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

安装 • 快速开始 • 文档 •

______________________________________________________________________

🎯 什么是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

______________________________________________________________________

✨ 特性

______________________________________________________________________

🚀 快速开始

安装

# 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 --交互式项目设置

______________________________________________________________________

📚 命令

核心命令

选项

# 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——请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

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

• 🐛 报告问题