gsd-trae 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.2] - 2026-02-26
+
+### Changed
+- 添加 `files` 字段到 `package.json`，排除 `refs/` 目录，大幅减小 npm 包体积 (5.6MB → ~34KB)
+- 压缩 `assets/screenshot.png` (106KB → 26KB)
+
+## [1.0.1] - 2026-02-26
+
+### Added
+- `install.sh` 现在会检测已存在的 `project_rules.md` 并报错提示
+- 重新设计了安装流程，使用仓库内的 `project_rules.md` 模板
+
+### Fixed
+- 修复 `project_rules.md` 链接指向 `~/.gsd-source` 的问题
+- 修正 `project_rules.md` 的安装位置为 `.trae/rules/`
+
+### Changed
+- `install.sh` 重构：使用仓库内的模板文件替代手写模板
+- 格式化 `README.md`，添加截图和 lint 脚本
+- 精简 README 格式并添加 Trae 适配说明
+- 将 README 截图移至本地 `assets` 目录
+- 更新 README 以包含项目的别名
+
+### Removed
+- 删除不再使用的项目规则文档
+
+## [1.0.0] - 2025-02-26
+
+### Added
+- 初始版本发布
+- GSD (Get Shit Done) framework adapter for Trae IDE
+- CLI 安装脚本
+- 项目规则模板

package/README.md

@@ -1,11 +1,9 @@
 # GSD for Trae
 
-为 [Trae](https://www.trae.ai/) 适配的 GSD（Get Shit Done）框架版本。
+为 [Trae](https://www.trae.ai/) 适配的 GSD（Get Shit Done）框架版本，aka get-shit-done-trae or gsd-trae。
 
 GSD 是一个轻量级、强大的元提示（Meta-prompting）、上下文工程（Context Engineering）和规格驱动开发（Spec-driven Development）系统。
 
----
-
 ## 什么是 GSD
 
 GSD 通过流程约束解决了**上下文衰减（Context Rot）**问题——当 Claude 的上下文窗口被填满时，代码质量会逐渐下降的现象。
@@ -17,19 +15,17 @@ GSD 通过流程约束解决了**上下文衰减（Context Rot）**问题——
 - **状态管理**：跟踪项目进度，支持断点续传
 - **目标回溯验证（Goal-backward Verification）**：确保每个阶段真正达成目标
 
----
-
 ## 本项目
 
 这是 GSD 的 **Trae 适配版本**，将 GSD 的强大工作流引入 Trae IDE：
 
-| 特性                     | 说明                                                           |
-| ------------------------ | -------------------------------------------------------------- |
+| 特性                           | 说明                                                           |
+| ------------------------------ | -------------------------------------------------------------- |
 | `.trae/rules/project_rules.md` | Trae 项目级规则，替代 `.claude/` 目录                          |
-| 完整工作流支持           | `/gsd:new-project`、`/gsd:plan-phase`、`/gsd:execute-phase` 等 |
-| 中文优化                 | 针对中文开发者优化的提示和文档                                 |
+| 完整工作流支持                 | `/gsd:new-project`、`/gsd:plan-phase`、`/gsd:execute-phase` 等 |
+| 中文优化                       | 针对中文开发者优化的提示和文档                                 |
 
----
+注意，GSD 的提示词是为 Claude 优化的，如果在 Trae 中使用，个人推荐使用 Gemini-3-pro、Kimi K2.5、GLM-5，减少使用 GPT 5.2
 
 ## 快速开始
 
@@ -71,7 +67,7 @@ bash ~/.config/gsd-trae/install.sh
 /gsd:new-project
 ```
 
----
+![](./assets/screenshot.png)
 
 ## 核心命令
 
@@ -85,35 +81,6 @@ bash ~/.config/gsd-trae/install.sh
 | `/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）
@@ -138,44 +105,10 @@ bash ~/.config/gsd-trae/install.sh
 /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` 会执行以下操作：
@@ -186,8 +119,6 @@ bash ~/.config/gsd-trae/install.sh
 
 这样多个项目可以共享同一份 GSD 源文件，同时每个项目有自己的 Trae 规则配置。
 
----
-
 ## 许可证
 
 MIT License

package/package.json

@@ -1,17 +1,19 @@
 {
   "name": "gsd-trae",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "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"
+    "lint": "npx prettier --write README.md"
   },
   "keywords": [
     "gsd",
     "trae",
+    "gsd-trae",
+    "get-shit-done-trae",
     "ai",
     "workflow",
     "project-management"
@@ -25,5 +27,12 @@
   "bugs": {
     "url": "https://github.com/Lionad-Morotar/get-shit-done-trae/issues"
   },
-  "homepage": "https://github.com/Lionad-Morotar/get-shit-done-trae#readme"
+  "homepage": "https://github.com/Lionad-Morotar/get-shit-done-trae#readme",
+  "files": [
+    "bin/",
+    "assets/",
+    "install.sh",
+    "README.md",
+    "CHANGELOG.md"
+  ]
 }

package/.claude/settings.local.json

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

package/.gitmodules

@@ -1,6 +0,0 @@
-[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

@@ -1,56 +0,0 @@
-# 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

@@ -1,56 +0,0 @@
-# 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

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

package/refs/gsd/.github/CODEOWNERS

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

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

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

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

@@ -1,59 +0,0 @@
----
-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

@@ -1,37 +0,0 @@
----
-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

@@ -1,24 +0,0 @@
-## 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

@@ -1,21 +0,0 @@
-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"]
-            })