@geeseeker/easyai-dev 3.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GeeSeeker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+<div align="center">
+
+# easyAI-dev
+
+**AI Agent 协作框架 — 让 AI 团队帮你完成整个开发流程**
+
+[![npm version](https://img.shields.io/npm/v/@geeseeker/easyai-dev.svg?style=flat-square&color=blue)](https://www.npmjs.com/package/@geeseeker/easyai-dev)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![Antigravity](https://img.shields.io/badge/IDE-Antigravity-purple.svg?style=flat-square)](https://antigravity.dev)
+
+⭐ 觉得有用？Star 一下支持我们！
+
+</div>
+
+---
+
+## 这是什么？
+
+easyAI 是一个为 [Antigravity IDE](https://antigravity.dev) 打造的 **AI Agent 协作框架**。它在你的 IDE 里组建了一支 AI 团队，覆盖从需求分析到代码交付的完整开发流程。
+
+**即使你完全不懂代码，也能通过 AI 协作完成高质量的软件开发。**
+
+### 核心亮点
+
+- 🛡️ **9 条硬阻断 + 12 条 Red Flags** — 流程纪律，防止 AI 跳步
+- 🔒 **风险分级代码审查** — 低风险自动通过，高风险交叉验证
+- 🧪 **TDD 红绿重构铁律** — 先写失败测试再写代码
+- 🧠 **知识沉淀闭环** — 每次任务的经验自动归档，越用越聪明
+- 🤖 **多 AI 协作** — 通过 MCP 调度 Claude Code / Codex / Gemini CLI
+
+---
+
+## 快速安装
+
+> **前置要求**：[Antigravity IDE](https://antigravity.dev) + [Node.js](https://nodejs.org/) (v18+)
+
+复制下面这段话，粘贴到 Antigravity 的对话框中：
+
+```
+请帮我安装 easyAI-dev 框架。
+仓库地址：https://github.com/GeeSeeker/easyAI-3.0
+请克隆仓库后阅读 README_AI.md，按步骤自动完成配置。
+```
+
+AI 会自动帮你完成以下所有步骤：
+
+1. ✅ 安装 `@geeseeker/easyai-dev` CLI 工具
+2. ✅ 配置 MCP Server（Claude Code / Gemini / Codex）
+3. ✅ 验证环境可用性
+
+安装完成后，AI 会告诉你如何初始化项目。
+
+---
+
+## 日常使用
+
+### 新项目初始化
+
+```bash
+cd my-project
+easyai-dev init
+```
+
+这会在项目中生成：
+
+- `.agents/` — 规则、工作流、技能链（AI 的大脑）
+- `.trellis/` — 规范库、会话记忆、任务看板（项目记忆）
+
+### 框架升级
+
+```bash
+npm update -g @geeseeker/easyai-dev   # 升级 CLI 工具
+easyai-dev update                       # 更新项目中的框架文件
+```
+
+---
+
+## 角色体系
+
+easyAI 采用**角色与 AI 解耦**的设计：角色定义职责，AI 是执行角色的载体。
+
+| 角色            | 定位         | 职责                                     |
+| --------------- | ------------ | ---------------------------------------- |
+| 🎯 **项目经理** | 资源调度中枢 | 与用户沟通、拆分任务、验收审查、知识沉淀 |
+| 🔧 **技术主管** | 外包工头     | 调度外部 CLI、处理 Diff、技术执行        |
+| 💻 **开发者**   | 核心骨干     | TDD 编码、精细重构、兜底开发             |
+| 🔍 **审核员**   | 架构评审     | 核心 Milestone 把关、一票否决            |
+| 🛠️ **助理**     | 机动支持     | 环境配置、资料检索（免硬阻断）           |
+
+---
+
+## 工作流体系
+
+| 工作流     | 说明                                          |
+| ---------- | --------------------------------------------- |
+| 开工检查   | 上下文恢复 + 硬阻断检查 + Red Flags 自检      |
+| 需求脑暴   | 苏格拉底式提问，将想法转化为设计              |
+| 微任务撰写 | BDD 验收标准 + 测试契约卡片                   |
+| TDD 开发   | RED → GREEN → REFACTOR                        |
+| 代码审查   | 自动化验证 → PM 审查 → 交叉验证（按风险分级） |
+| 系统化调试 | 根因调查 → 模式分析 → 假设验证 → 修复         |
+| 收工流程   | Git 卫生 + 知识沉淀 + 会话记录                |
+
+---
+
+## 致谢
+
+easyAI 的诞生离不开以下优秀项目的启发 🙏
+
+### 参考项目
+
+| 项目                                                         | 融合点                                |
+| ------------------------------------------------------------ | ------------------------------------- |
+| [Trellis](https://github.com/mindfold-ai/Trellis)            | 会话持久化、Spec 规范库、任务看板     |
+| [superpowers](https://github.com/obra/superpowers)           | TDD 铁律、系统化调试、强制 Skill 触发 |
+| [ccg-workflow](https://github.com/fengshao1227/ccg-workflow) | 多模型编排、安全沙箱                  |
+| [GuDa-spec](https://github.com/GuDaStudio/commands)          | 零歧义目标检查、约束集                |
+
+### MCP Server
+
+| 项目                                                           | 用途                 |
+| -------------------------------------------------------------- | -------------------- |
+| [claude-code-mcp](https://github.com/steipete/claude-code-mcp) | Claude Code CLI 调用 |
+| [codexmcp](https://github.com/GuDaStudio/codexmcp)             | Codex CLI 调用       |
+| [geminimcp](https://github.com/GuDaStudio/geminimcp)           | Gemini CLI 调用      |
+
+---
+
+## 许可证
+
+[MIT License](LICENSE) © 2025 GeeSeeker

package/bin/easyai-dev.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import("../src/cli/index.js");

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@geeseeker/easyai-dev",
+  "version": "3.0.0-alpha.1",
+  "description": "AI Agent 协作框架 — 为 Antigravity IDE 打造的 AI 团队工作流",
+  "type": "module",
+  "bin": {
+    "easyai-dev": "bin/easyai-dev.js"
+  },
+  "scripts": {
+    "test": "echo \"TODO: add tests\" && exit 0"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "workflow",
+    "antigravity",
+    "developer-tools",
+    "tdd",
+    "code-review"
+  ],
+  "author": "GeeSeeker",
+  "license": "MIT",
+  "files": [
+    "bin",
+    "src",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GeeSeeker/easyAI-3.0.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/cli/index.js

@@ -0,0 +1,40 @@
+import { Command } from "commander";
+import { init } from "../commands/init.js";
+import { update } from "../commands/update.js";
+
+const program = new Command();
+
+program
+  .name("easyai-dev")
+  .description("AI Agent 协作框架 — 为 Antigravity IDE 打造的 AI 团队工作流")
+  .version("3.0.0-alpha.1", "-v, --version", "输出版本号");
+
+program
+  .command("init")
+  .description("在当前项目中初始化 easyAI 框架")
+  .option("-f, --force", "覆盖已存在的文件")
+  .option("-s, --skip-existing", "跳过已存在的文件")
+  .action(async (options) => {
+    try {
+      await init(options);
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program
+  .command("update")
+  .description("更新当前项目中的 easyAI 框架文件到最新版本")
+  .option("--dry-run", "预览变更，不实际执行")
+  .option("-f, --force", "强制覆盖所有变更文件")
+  .action(async (options) => {
+    try {
+      await update(options);
+    } catch (error) {
+      console.error("Error:", error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });
+
+program.parse();

package/src/commands/init.js

@@ -0,0 +1,37 @@
+import fs from "node:fs";
+import path from "node:path";
+
+/**
+ * easyai-dev init — 在当前项目中初始化 easyAI 框架
+ *
+ * 将 templates/ 中的文件复制到用户项目：
+ * - templates/agents/ → .agents/
+ * - templates/trellis/ → .trellis/
+ */
+export async function init(options = {}) {
+  const cwd = process.cwd();
+
+  console.log("\n🚀 easyAI-dev 初始化\n");
+
+  // 检查是否已初始化
+  const agentsDir = path.join(cwd, ".agents");
+  const trellisDir = path.join(cwd, ".trellis");
+
+  if (fs.existsSync(agentsDir) && !options.force) {
+    console.log("⚠️  .agents/ 目录已存在。使用 --force 强制覆盖。");
+    return;
+  }
+
+  // TODO: 实现模板复制逻辑
+  // 1. 定位 templates/ 目录（npm 包内）
+  // 2. 递归复制 templates/agents/ → .agents/
+  // 3. 递归复制 templates/trellis/ → .trellis/
+  // 4. 追加 .gitignore 条目
+
+  console.log("📁 创建 .agents/ ...");
+  console.log("📁 创建 .trellis/ ...");
+  console.log("\n✅ easyAI-dev 初始化完成！");
+  console.log("\n后续步骤：");
+  console.log("  1. 在 Antigravity 中打开项目");
+  console.log("  2. 输入 /项目经理 开始工作\n");
+}

package/src/commands/update.js

@@ -0,0 +1,33 @@
+import fs from "node:fs";
+import path from "node:path";
+
+/**
+ * easyai-dev update — 更新当前项目的 easyAI 框架文件到最新版本
+ *
+ * 对比 templates/ 与用户项目中 .agents/ 和 .trellis/ 的差异，
+ * 仅更新框架文件（不覆盖用户自定义内容）。
+ */
+export async function update(options = {}) {
+  const cwd = process.cwd();
+
+  console.log("\n🔄 easyAI-dev 更新检查\n");
+
+  // 检查是否已初始化
+  const agentsDir = path.join(cwd, ".agents");
+  if (!fs.existsSync(agentsDir)) {
+    console.log("❌ 未检测到 .agents/ 目录。请先运行 easyai-dev init");
+    return;
+  }
+
+  // TODO: 实现更新逻辑
+  // 1. 读取用户项目中的 .agents/.version
+  // 2. 对比 templates/ 中的版本
+  // 3. 差异对比，列出变更文件
+  // 4. 按策略更新（force / skip / ask）
+
+  if (options.dryRun) {
+    console.log("📋 预览模式 — 不会实际修改文件\n");
+  }
+
+  console.log("✅ 已是最新版本，无需更新。\n");
+}

package/templates/README.md

@@ -0,0 +1,22 @@
+# easyAI 模板目录
+
+此目录包含 `easyai-dev init` 命令初始化时复制到用户项目的模板文件。
+
+## 结构
+
+```
+templates/
+├── agents/          → 复制为用户项目的 .agents/
+│   ├── rules/       #   Always-On Rule
+│   ├── workflows/   #   角色切换 workflow
+│   ├── skills/      #   全部 skill 链
+│   ├── templates/   #   任务模板
+│   └── scripts/     #   辅助脚本
+└── trellis/         → 复制为用户项目的 .trellis/
+    ├── workflow.md   #   任务生命周期
+    ├── spec/         #   规范知识库（初始结构）
+    ├── workspace/    #   会话记忆
+    └── tasks/        #   任务看板
+```
+
+> **注意**：模板内容将在后续开发任务中逐步填充。

package/templates/agents/README.md

@@ -0,0 +1,4 @@
+# easyAI Agents 模板
+
+> 此目录在 `easyai-dev init` 时会被复制为用户项目的 `.agents/` 目录。
+> 模板内容将在后续开发任务中从 `easyAI-dev/.agents/` 提炼填充。

package/templates/trellis/README.md

@@ -0,0 +1,4 @@
+# easyAI Trellis 模板
+
+> 此目录在 `easyai-dev init` 时会被复制为用户项目的 `.trellis/` 目录。
+> 模板内容将在后续开发任务中从 `easyAI-dev/.trellis/` 提炼填充。