gsd-trae 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "mcp__web-search-prime__webSearchPrime",
+      "mcp__web-reader__webReader"
+    ]
+  }
+}

package/.gitmodules

@@ -0,0 +1,6 @@
+[submodule "refs/gsd"]
+	path = refs/gsd
+	url = https://github.com/glittercowboy/get-shit-done.git
+[submodule "refs/vbenchmark"]
+	path = refs/vbenchmark
+	url = https://github.com/alt-research/vibe-coding-benchmark-public.git

package/.trae/project_rules.md

@@ -0,0 +1,56 @@
+# AGENTS.md
+
+面向 AI 编程助手的项目级指导文档（基于 GSD 框架）。
+
+## 可用资源
+
+`.planning/` 中的所有资源均可调用或引用：
+
+### 智能助手（Agents）
+
+| 助手 | 文件 | 用途 |
+|------|------|---------|
+| `@project-researcher` | `agents/gsd-project-researcher.md` | 研究领域生态系统 |
+| `@research-synthesizer` | `agents/gsd-research-synthesizer.md` | 综合研究成果 |
+| `@roadmapper` | `agents/gsd-roadmapper.md` | 创建项目路线图 |
+| `@planner` | `agents/gsd-planner.md` | 创建阶段计划 |
+| `@phase-researcher` | `agents/gsd-phase-researcher.md` | 研究阶段实现方案 |
+| `@plan-checker` | `agents/gsd-plan-checker.md` | 验证计划是否达成目标 |
+| `@executor` | `agents/gsd-executor.md` | 执行阶段计划 |
+| `@verifier` | `agents/gsd-verifier.md` | 验证阶段完成情况 |
+| `@debugger` | `agents/gsd-debugger.md` | 系统化调试 |
+| `@codebase-mapper` | `agents/gsd-codebase-mapper.md` | 映射现有代码库 |
+| `@integration-checker` | `agents/gsd-integration-checker.md` | 验证跨阶段集成 |
+
+### 工作流
+
+通过 `/gsd:command` 触发：
+
+| 工作流 | 文件 | 用途 |
+|----------|------|---------|
+| `/gsd:new-project` | `workflows/new-project.md` | 初始化新项目 |
+| `/gsd:new-milestone` | `workflows/new-milestone.md` | 开始新里程碑 |
+| `/gsd:discuss-phase` | `workflows/discuss-phase.md` | 收集阶段上下文 |
+| `/gsd:plan-phase` | `workflows/plan-phase.md` | 创建阶段计划 |
+| `/gsd:execute-phase` | `workflows/execute-phase.md` | 执行阶段计划 |
+| `/gsd:verify-work` | `workflows/verify-work.md` | 验证交付物 |
+| `/gsd:audit-milestone` | `workflows/audit-milestone.md` | 审计里程碑完成情况 |
+| `/gsd:complete-milestone` | `workflows/complete-milestone.md` | 归档已完成的里程碑 |
+| `/gsd:map-codebase` | `workflows/map-codebase.md` | 分析现有代码 |
+| `/gsd:progress` | `workflows/progress.md` | 检查项目进度 |
+| `/gsd:debug` | `workflows/execute-phase.md` | 系统化调试 |
+| `/gsd:health` | `workflows/health.md` | 诊断规划健康状况 |
+| `/gsd:settings` | `workflows/settings.md` | 配置工作流偏好 |
+
+### 参考文档
+
+| 参考 | 文件 | 内容 |
+|-----------|------|---------|
+| 提问技巧 | `references/questioning.md` | 深度提问技术 |
+| UI 品牌 | `references/ui-brand.md` | 输出视觉规范 |
+| 模型配置 | `references/model-profiles.md` | AI 模型选择 |
+| 规划配置 | `references/planning-config.md` | 配置选项 |
+| Git 集成 | `references/git-integration.md` | Git 工作流模式 |
+| 测试驱动开发 | `references/tdd.md` | 测试驱动开发 |
+| 检查点 | `references/checkpoints.md` | 检查点模式 |
+| 验证策略 | `references/verification-patterns.md` | 验证策略 |

package/.trae/rules/project_rules.md

@@ -0,0 +1,56 @@
+# AGENTS.md
+
+面向 AI 编程助手的项目级指导文档（基于 GSD 框架）。
+
+## 可用资源
+
+`.planning/` 中的所有资源均可调用或引用：
+
+### 智能助手（Agents）
+
+| 助手 | 文件 | 用途 |
+|------|------|---------|
+| `@project-researcher` | `~/.gsd-source/agents/gsd-project-researcher.md` | 研究领域生态系统 |
+| `@research-synthesizer` | `~/.gsd-source/agents/gsd-research-synthesizer.md` | 综合研究成果 |
+| `@roadmapper` | `~/.gsd-source/agents/gsd-roadmapper.md` | 创建项目路线图 |
+| `@planner` | `~/.gsd-source/agents/gsd-planner.md` | 创建阶段计划 |
+| `@phase-researcher` | `~/.gsd-source/agents/gsd-phase-researcher.md` | 研究阶段实现方案 |
+| `@plan-checker` | `~/.gsd-source/agents/gsd-plan-checker.md` | 验证计划是否达成目标 |
+| `@executor` | `~/.gsd-source/agents/gsd-executor.md` | 执行阶段计划 |
+| `@verifier` | `~/.gsd-source/agents/gsd-verifier.md` | 验证阶段完成情况 |
+| `@debugger` | `~/.gsd-source/agents/gsd-debugger.md` | 系统化调试 |
+| `@codebase-mapper` | `~/.gsd-source/agents/gsd-codebase-mapper.md` | 映射现有代码库 |
+| `@integration-checker` | `~/.gsd-source/agents/gsd-integration-checker.md` | 验证跨阶段集成 |
+
+### 工作流
+
+通过 `/gsd:command` 触发：
+
+| 工作流 | 文件 | 用途 |
+|----------|------|---------|
+| `/gsd:new-project` | `~/.gsd-source/commands/gsd/new-project.md` | 初始化新项目 |
+| `/gsd:new-milestone` | `~/.gsd-source/commands/gsd/new-milestone.md` | 开始新里程碑 |
+| `/gsd:discuss-phase` | `~/.gsd-source/commands/gsd/discuss-phase.md` | 收集阶段上下文 |
+| `/gsd:plan-phase` | `~/.gsd-source/commands/gsd/plan-phase.md` | 创建阶段计划 |
+| `/gsd:execute-phase` | `~/.gsd-source/commands/gsd/execute-phase.md` | 执行阶段计划 |
+| `/gsd:verify-work` | `~/.gsd-source/commands/gsd/verify-work.md` | 验证交付物 |
+| `/gsd:audit-milestone` | `~/.gsd-source/commands/gsd/audit-milestone.md` | 审计里程碑完成情况 |
+| `/gsd:complete-milestone` | `~/.gsd-source/commands/gsd/complete-milestone.md` | 归档已完成的里程碑 |
+| `/gsd:map-codebase` | `~/.gsd-source/commands/gsd/map-codebase.md` | 分析现有代码 |
+| `/gsd:progress` | `~/.gsd-source/commands/gsd/progress.md` | 检查项目进度 |
+| `/gsd:debug` | `~/.gsd-source/commands/gsd/debug.md` | 系统化调试 |
+| `/gsd:health` | `~/.gsd-source/commands/gsd/health.md` | 诊断规划健康状况 |
+| `/gsd:settings` | `~/.gsd-source/commands/gsd/settings.md` | 配置工作流偏好 |
+
+### 参考文档
+
+| 参考 | 文件 | 内容 |
+|-----------|------|---------|
+| 提问技巧 | `~/.gsd-source/references/questioning.md` | 深度提问技术 |
+| UI 品牌 | `~/.gsd-source/references/ui-brand.md` | 输出视觉规范 |
+| 模型配置 | `~/.gsd-source/references/model-profiles.md` | AI 模型选择 |
+| 规划配置 | `~/.gsd-source/references/planning-config.md` | 配置选项 |
+| Git 集成 | `~/.gsd-source/references/git-integration.md` | Git 工作流模式 |
+| 测试驱动开发 | `~/.gsd-source/references/tdd.md` | 测试驱动开发 |
+| 检查点 | `~/.gsd-source/references/checkpoints.md` | 检查点模式 |
+| 验证策略 | `~/.gsd-source/references/verification-patterns.md` | 验证策略 |

package/.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+  "cSpell.words": [
+    "roadmapper"
+  ]
+}

package/README.md

@@ -0,0 +1,193 @@
+# GSD for Trae
+
+为 [Trae](https://www.trae.ai/) 适配的 GSD（Get Shit Done）框架版本。
+
+GSD 是一个轻量级、强大的元提示（Meta-prompting）、上下文工程（Context Engineering）和规格驱动开发（Spec-driven Development）系统。
+
+---
+
+## 什么是 GSD
+
+GSD 通过流程约束解决了**上下文衰减（Context Rot）**问题——当 Claude 的上下文窗口被填满时，代码质量会逐渐下降的现象。
+
+它通过以下方式实现：
+
+- **上下文工程**：在 `.planning/` 目录中持久化项目上下文
+- **智能体编排（Subagent Orchestration）**：并行调度多个专业 Agent 完成复杂任务
+- **状态管理**：跟踪项目进度，支持断点续传
+- **目标回溯验证（Goal-backward Verification）**：确保每个阶段真正达成目标
+
+---
+
+## 本项目
+
+这是 GSD 的 **Trae 适配版本**，将 GSD 的强大工作流引入 Trae IDE：
+
+| 特性                     | 说明                                                           |
+| ------------------------ | -------------------------------------------------------------- |
+| `.trae/rules/project_rules.md` | Trae 项目级规则，替代 `.claude/` 目录                          |
+| 完整工作流支持           | `/gsd:new-project`、`/gsd:plan-phase`、`/gsd:execute-phase` 等 |
+| 中文优化                 | 针对中文开发者优化的提示和文档                                 |
+
+---
+
+## 快速开始
+
+### 方式一：使用 npx（推荐）
+
+在项目根目录运行：
+
+```bash
+npx gsd-trae
+```
+
+### 方式二：使用 curl
+
+在项目根目录运行：
+
+```bash
+bash <(curl -s https://raw.githubusercontent.com/Lionad-Morotar/get-shit-done-trae/main/install.sh)
+```
+
+### 方式三：手动安装
+
+1. 克隆本仓库到固定位置：
+
+```bash
+git clone https://github.com/Lionad-Morotar/get-shit-done-trae.git ~/.config/gsd-trae
+```
+
+2. 运行安装脚本：
+
+```bash
+bash ~/.config/gsd-trae/install.sh
+```
+
+### 开始工作
+
+安装完成后，在 Trae 的 AI 对话中输入：
+
+```
+/gsd:new-project
+```
+
+---
+
+## 核心命令
+
+| 命令                   | 用途                                      |
+| ---------------------- | ----------------------------------------- |
+| `/gsd:new-project`     | 初始化新项目：提问 → 研究 → 需求 → 路线图 |
+| `/gsd:discuss-phase N` | 收集第 N 阶段的上下文                     |
+| `/gsd:plan-phase N`    | 为第 N 阶段创建详细计划                   |
+| `/gsd:execute-phase N` | 执行第 N 阶段的所有计划                   |
+| `/gsd:verify-work`     | 验证交付物是否符合要求                    |
+| `/gsd:progress`        | 检查项目进度                              |
+| `/gsd:map-codebase`    | 分析现有代码库                            |
+
+---
+
+## 项目结构
+
+运行 `/gsd:new-project` 后将创建：
+
+```
+.planning/
+├── PROJECT.md          # 项目上下文、核心价值和需求
+├── REQUIREMENTS.md     # 带 REQ-ID 的详细需求
+├── ROADMAP.md          # 分阶段路线图
+├── STATE.md            # 当前项目状态
+├── config.json         # 工作流配置
+├── research/           # 领域研究（可选）
+│   ├── STACK.md
+│   ├── FEATURES.md
+│   ├── ARCHITECTURE.md
+│   ├── PITFALLS.md
+│   └── SUMMARY.md
+└── phases/             # 各阶段计划和产物
+    ├── phase-01/
+    │   ├── PLAN.md
+    │   └── ...
+    └── phase-02/
+        └── ...
+```
+
+---
+
+## 工作流程
+
+### 新项目（Greenfield）
+
+```
+/gsd:new-project
+   ↓
+深度提问 → 研究（可选）→ 定义需求 → 创建路线图
+   ↓
+/gsd:discuss-phase 1 → /gsd:plan-phase 1 → /gsd:execute-phase 1
+   ↓
+/gsd:verify-work
+   ↓
+进入 Phase 2...
+```
+
+### 已有代码（Brownfield）
+
+```
+/gsd:map-codebase      # 先分析现有代码
+   ↓
+/gsd:new-project       # 基于现有上下文规划新功能
+```
+
+---
+
+## 配置
+
+`.planning/config.json`：
+
+```json
+{
+  "mode": "yolo",
+  "depth": "standard",
+  "parallelization": true,
+  "commit_docs": true,
+  "model_profile": "balanced",
+  "workflow": {
+    "research": true,
+    "plan_check": true,
+    "verifier": true,
+    "auto_advance": false
+  }
+}
+```
+
+| 配置项            | 选项                                   | 说明                                |
+| ----------------- | -------------------------------------- | ----------------------------------- |
+| `mode`            | `yolo` / `interactive`                 | YOLO 模式自动批准，交互模式逐步确认 |
+| `depth`           | `quick` / `standard` / `comprehensive` | 规划深度                            |
+| `parallelization` | `true` / `false`                       | 是否并行执行独立计划                |
+| `commit_docs`     | `true` / `false`                       | 是否将规划文档提交到 Git            |
+| `model_profile`   | `quality` / `balanced` / `budget`      | AI 模型选择策略                     |
+
+---
+
+## 参考
+
+- [GSD 原项目](https://github.com/glittercowboy/get-shit-done) - 官方仓库
+
+---
+
+## 工作原理
+
+安装脚本 `install.sh` 会执行以下操作：
+
+1. 将 GSD 源文件克隆到 `~/.gsd-source`
+2. 在当前项目创建 `.trae/rules/project_rules.md`
+3. `project_rules.md` 中的链接指向 `~/.gsd-source` 下的实际文件
+
+这样多个项目可以共享同一份 GSD 源文件，同时每个项目有自己的 Trae 规则配置。
+
+---
+
+## 许可证
+
+MIT License

package/bin/cli.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process');
+const path = require('path');
+
+const installScript = path.join(__dirname, '..', 'install.sh');
+
+try {
+  execSync(`bash "${installScript}"`, { stdio: 'inherit' });
+} catch (error) {
+  console.error('安装失败:', error.message);
+  process.exit(1);
+}

package/install.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+
+# GSD for Trae - 安装脚本
+# 用法: bash <(curl -s https://raw.githubusercontent.com/Lionad-Morotar/get-shit-done-trae/main/install.sh)
+
+set -e
+
+GSD_SOURCE="$HOME/.gsd-source"
+GSD_REPO="https://github.com/glittercowboy/get-shit-done.git"
+REPO_URL="https://github.com/Lionad-Morotar/get-shit-done-trae"
+
+echo "🔧 安装 GSD for Trae..."
+
+# 1. 下载 GSD 源文件到 ~/.gsd-source
+if [ ! -d "$GSD_SOURCE/.git" ]; then
+    echo "📥 下载 GSD 源文件到 $GSD_SOURCE..."
+    rm -rf "$GSD_SOURCE"
+    git clone --depth 1 "$GSD_REPO" "$GSD_SOURCE" >/dev/null 2>&1
+else
+    echo "📥 更新 GSD 源文件..."
+    cd "$GSD_SOURCE" && git pull >/dev/null 2>&1
+fi
+
+# 2. 检查是否已存在 project_rules.md
+if [ -f ".trae/rules/project_rules.md" ]; then
+    echo "❌ 错误: .trae/rules/project_rules.md 已存在"
+    echo ""
+    echo "如需重新安装，请先删除现有文件："
+    echo "   rm .trae/rules/project_rules.md"
+    echo ""
+    echo "或手动备份后重命名："
+    echo "   mv .trae/rules/project_rules.md .trae/rules/project_rules.md.backup"
+    exit 1
+fi
+
+# 3. 创建 .trae/rules 目录
+if [ ! -d ".trae/rules" ]; then
+    echo "📁 创建 .trae/rules 目录..."
+    mkdir -p ".trae/rules"
+fi
+
+# 4. 复制 project_rules.md
+PROJECT_RULES_SOURCE=""
+
+# 优先从脚本所在目录查找
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [ -f "$SCRIPT_DIR/.trae/rules/project_rules.md" ]; then
+    PROJECT_RULES_SOURCE="$SCRIPT_DIR/.trae/rules/project_rules.md"
+elif [ -f "$SCRIPT_DIR/project_rules.md" ]; then
+    PROJECT_RULES_SOURCE="$SCRIPT_DIR/project_rules.md"
+fi
+
+# 如果没找到，从远程仓库下载
+if [ -z "$PROJECT_RULES_SOURCE" ]; then
+    echo "📥 从远程仓库下载 project_rules.md..."
+    curl -fsSL "$REPO_URL/raw/main/.trae/rules/project_rules.md" -o ".trae/rules/project_rules.md" 2>/dev/null || \
+    curl -fsSL "$REPO_URL/raw/main/.trae/project_rules.md" -o ".trae/rules/project_rules.md" 2>/dev/null
+    if [ $? -eq 0 ]; then
+        echo "✅ project_rules.md 下载成功"
+    else
+        echo "❌ 无法下载 project_rules.md，请检查网络连接"
+        exit 1
+    fi
+else
+    echo "📝 复制 project_rules.md..."
+    cp "$PROJECT_RULES_SOURCE" ".trae/rules/project_rules.md"
+fi
+
+echo ""
+echo "✅ 安装完成！"
+echo ""
+echo "📍 文件位置:"
+echo "   GSD 源文件: $GSD_SOURCE"
+echo "   项目规则: $(pwd)/.trae/rules/project_rules.md"
+echo ""
+echo "🚀 开始使用:"
+echo "   在 Trae 中输入 /gsd:new-project"

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "gsd-trae",
+  "version": "1.0.0",
+  "description": "GSD (Get Shit Done) framework adapter for Trae IDE",
+  "main": "bin/cli.js",
+  "bin": {
+    "gsd-trae": "bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "gsd",
+    "trae",
+    "ai",
+    "workflow",
+    "project-management"
+  ],
+  "author": "Lionad-Morotar",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Lionad-Morotar/get-shit-done-trae.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Lionad-Morotar/get-shit-done-trae/issues"
+  },
+  "homepage": "https://github.com/Lionad-Morotar/get-shit-done-trae#readme"
+}

package/refs/gsd/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# All changes require review from project owner
+* @glittercowboy

package/refs/gsd/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: glittercowboy

package/refs/gsd/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,59 @@
+---
+name: Bug Report
+description: Report something that is not working correctly
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug. Please fill out the sections below.
+  - type: input
+    id: version
+    attributes:
+      label: GSD Version
+      description: "Run: npm list -g get-shit-done-cc"
+      placeholder: "e.g., 1.18.0"
+    validations:
+      required: true
+  - type: dropdown
+    id: runtime
+    attributes:
+      label: Runtime
+      options:
+        - Claude Code
+        - Gemini CLI
+        - OpenCode
+    validations:
+      required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: What happened?
+      description: Describe what went wrong
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect?
+      description: Describe what you expected to happen
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: How can we reproduce this?
+      placeholder: |
+        1. Run /gsd:...
+        2. ...
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant logs or error messages
+      description: Paste any error output (will be formatted as code)
+      render: shell
+    validations:
+      required: false

package/refs/gsd/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,37 @@
+---
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature\! Please describe what you would like to see.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem or motivation
+      description: What problem does this solve? Why do you want this?
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: How do you think this should work?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Have you considered other approaches?
+    validations:
+      required: false
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Any other information, screenshots, or examples
+    validations:
+      required: false

package/refs/gsd/.github/pull_request_template.md

@@ -0,0 +1,24 @@
+## What
+
+<!-- One sentence: what does this PR do? -->
+
+## Why
+
+<!-- One sentence: why is this change needed? -->
+
+## Testing
+
+- [ ] Tested on macOS
+- [ ] Tested on Windows
+- [ ] Tested on Linux
+
+## Checklist
+
+- [ ] Follows GSD style (no enterprise patterns, no filler)
+- [ ] Updates CHANGELOG.md for user-facing changes
+- [ ] No unnecessary dependencies added
+- [ ] Works on Windows (backslash paths tested)
+
+## Breaking Changes
+
+None

package/refs/gsd/.github/workflows/auto-label-issues.yml

@@ -0,0 +1,21 @@
+name: Auto-label new issues
+
+on:
+  issues:
+    types: [opened]
+
+jobs:
+  add-triage-label:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              labels: ["needs-triage"]
+            })