gsd-trae 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.vscode/settings.json +2 -1
- package/CHANGELOG.md +34 -0
- package/README.md +7 -76
- package/assets/screenshot.png +0 -0
- package/package.json +4 -2
- package/.trae/project_rules.md +0 -56
package/.vscode/settings.json
CHANGED
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to this project will be documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
## [1.0.1] - 2026-02-26
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
- `install.sh` 现在会检测已存在的 `project_rules.md` 并报错提示
|
|
12
|
+
- 重新设计了安装流程,使用仓库内的 `project_rules.md` 模板
|
|
13
|
+
|
|
14
|
+
### Fixed
|
|
15
|
+
- 修复 `project_rules.md` 链接指向 `~/.gsd-source` 的问题
|
|
16
|
+
- 修正 `project_rules.md` 的安装位置为 `.trae/rules/`
|
|
17
|
+
|
|
18
|
+
### Changed
|
|
19
|
+
- `install.sh` 重构:使用仓库内的模板文件替代手写模板
|
|
20
|
+
- 格式化 `README.md`,添加截图和 lint 脚本
|
|
21
|
+
- 精简 README 格式并添加 Trae 适配说明
|
|
22
|
+
- 将 README 截图移至本地 `assets` 目录
|
|
23
|
+
- 更新 README 以包含项目的别名
|
|
24
|
+
|
|
25
|
+
### Removed
|
|
26
|
+
- 删除不再使用的项目规则文档
|
|
27
|
+
|
|
28
|
+
## [1.0.0] - 2025-02-26
|
|
29
|
+
|
|
30
|
+
### Added
|
|
31
|
+
- 初始版本发布
|
|
32
|
+
- GSD (Get Shit Done) framework adapter for Trae IDE
|
|
33
|
+
- CLI 安装脚本
|
|
34
|
+
- 项目规则模板
|
package/README.md
CHANGED
|
@@ -1,11 +1,9 @@
|
|
|
1
1
|
# GSD for Trae
|
|
2
2
|
|
|
3
|
-
为 [Trae](https://www.trae.ai/) 适配的 GSD(Get Shit Done
|
|
3
|
+
为 [Trae](https://www.trae.ai/) 适配的 GSD(Get Shit Done)框架版本,aka get-shit-done-trae or gsd-trae。
|
|
4
4
|
|
|
5
5
|
GSD 是一个轻量级、强大的元提示(Meta-prompting)、上下文工程(Context Engineering)和规格驱动开发(Spec-driven Development)系统。
|
|
6
6
|
|
|
7
|
-
---
|
|
8
|
-
|
|
9
7
|
## 什么是 GSD
|
|
10
8
|
|
|
11
9
|
GSD 通过流程约束解决了**上下文衰减(Context Rot)**问题——当 Claude 的上下文窗口被填满时,代码质量会逐渐下降的现象。
|
|
@@ -17,19 +15,17 @@ GSD 通过流程约束解决了**上下文衰减(Context Rot)**问题——
|
|
|
17
15
|
- **状态管理**:跟踪项目进度,支持断点续传
|
|
18
16
|
- **目标回溯验证(Goal-backward Verification)**:确保每个阶段真正达成目标
|
|
19
17
|
|
|
20
|
-
---
|
|
21
|
-
|
|
22
18
|
## 本项目
|
|
23
19
|
|
|
24
20
|
这是 GSD 的 **Trae 适配版本**,将 GSD 的强大工作流引入 Trae IDE:
|
|
25
21
|
|
|
26
|
-
| 特性
|
|
27
|
-
|
|
|
22
|
+
| 特性 | 说明 |
|
|
23
|
+
| ------------------------------ | -------------------------------------------------------------- |
|
|
28
24
|
| `.trae/rules/project_rules.md` | Trae 项目级规则,替代 `.claude/` 目录 |
|
|
29
|
-
| 完整工作流支持
|
|
30
|
-
| 中文优化
|
|
25
|
+
| 完整工作流支持 | `/gsd:new-project`、`/gsd:plan-phase`、`/gsd:execute-phase` 等 |
|
|
26
|
+
| 中文优化 | 针对中文开发者优化的提示和文档 |
|
|
31
27
|
|
|
32
|
-
|
|
28
|
+
注意,GSD 的提示词是为 Claude 优化的,如果在 Trae 中使用,个人推荐使用 Gemini-3-pro、Kimi K2.5、GLM-5,减少使用 GPT 5.2
|
|
33
29
|
|
|
34
30
|
## 快速开始
|
|
35
31
|
|
|
@@ -71,7 +67,7 @@ bash ~/.config/gsd-trae/install.sh
|
|
|
71
67
|
/gsd:new-project
|
|
72
68
|
```
|
|
73
69
|
|
|
74
|
-
|
|
70
|
+

|
|
75
71
|
|
|
76
72
|
## 核心命令
|
|
77
73
|
|
|
@@ -85,35 +81,6 @@ bash ~/.config/gsd-trae/install.sh
|
|
|
85
81
|
| `/gsd:progress` | 检查项目进度 |
|
|
86
82
|
| `/gsd:map-codebase` | 分析现有代码库 |
|
|
87
83
|
|
|
88
|
-
---
|
|
89
|
-
|
|
90
|
-
## 项目结构
|
|
91
|
-
|
|
92
|
-
运行 `/gsd:new-project` 后将创建:
|
|
93
|
-
|
|
94
|
-
```
|
|
95
|
-
.planning/
|
|
96
|
-
├── PROJECT.md # 项目上下文、核心价值和需求
|
|
97
|
-
├── REQUIREMENTS.md # 带 REQ-ID 的详细需求
|
|
98
|
-
├── ROADMAP.md # 分阶段路线图
|
|
99
|
-
├── STATE.md # 当前项目状态
|
|
100
|
-
├── config.json # 工作流配置
|
|
101
|
-
├── research/ # 领域研究(可选)
|
|
102
|
-
│ ├── STACK.md
|
|
103
|
-
│ ├── FEATURES.md
|
|
104
|
-
│ ├── ARCHITECTURE.md
|
|
105
|
-
│ ├── PITFALLS.md
|
|
106
|
-
│ └── SUMMARY.md
|
|
107
|
-
└── phases/ # 各阶段计划和产物
|
|
108
|
-
├── phase-01/
|
|
109
|
-
│ ├── PLAN.md
|
|
110
|
-
│ └── ...
|
|
111
|
-
└── phase-02/
|
|
112
|
-
└── ...
|
|
113
|
-
```
|
|
114
|
-
|
|
115
|
-
---
|
|
116
|
-
|
|
117
84
|
## 工作流程
|
|
118
85
|
|
|
119
86
|
### 新项目(Greenfield)
|
|
@@ -138,44 +105,10 @@ bash ~/.config/gsd-trae/install.sh
|
|
|
138
105
|
/gsd:new-project # 基于现有上下文规划新功能
|
|
139
106
|
```
|
|
140
107
|
|
|
141
|
-
---
|
|
142
|
-
|
|
143
|
-
## 配置
|
|
144
|
-
|
|
145
|
-
`.planning/config.json`:
|
|
146
|
-
|
|
147
|
-
```json
|
|
148
|
-
{
|
|
149
|
-
"mode": "yolo",
|
|
150
|
-
"depth": "standard",
|
|
151
|
-
"parallelization": true,
|
|
152
|
-
"commit_docs": true,
|
|
153
|
-
"model_profile": "balanced",
|
|
154
|
-
"workflow": {
|
|
155
|
-
"research": true,
|
|
156
|
-
"plan_check": true,
|
|
157
|
-
"verifier": true,
|
|
158
|
-
"auto_advance": false
|
|
159
|
-
}
|
|
160
|
-
}
|
|
161
|
-
```
|
|
162
|
-
|
|
163
|
-
| 配置项 | 选项 | 说明 |
|
|
164
|
-
| ----------------- | -------------------------------------- | ----------------------------------- |
|
|
165
|
-
| `mode` | `yolo` / `interactive` | YOLO 模式自动批准,交互模式逐步确认 |
|
|
166
|
-
| `depth` | `quick` / `standard` / `comprehensive` | 规划深度 |
|
|
167
|
-
| `parallelization` | `true` / `false` | 是否并行执行独立计划 |
|
|
168
|
-
| `commit_docs` | `true` / `false` | 是否将规划文档提交到 Git |
|
|
169
|
-
| `model_profile` | `quality` / `balanced` / `budget` | AI 模型选择策略 |
|
|
170
|
-
|
|
171
|
-
---
|
|
172
|
-
|
|
173
108
|
## 参考
|
|
174
109
|
|
|
175
110
|
- [GSD 原项目](https://github.com/glittercowboy/get-shit-done) - 官方仓库
|
|
176
111
|
|
|
177
|
-
---
|
|
178
|
-
|
|
179
112
|
## 工作原理
|
|
180
113
|
|
|
181
114
|
安装脚本 `install.sh` 会执行以下操作:
|
|
@@ -186,8 +119,6 @@ bash ~/.config/gsd-trae/install.sh
|
|
|
186
119
|
|
|
187
120
|
这样多个项目可以共享同一份 GSD 源文件,同时每个项目有自己的 Trae 规则配置。
|
|
188
121
|
|
|
189
|
-
---
|
|
190
|
-
|
|
191
122
|
## 许可证
|
|
192
123
|
|
|
193
124
|
MIT License
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,17 +1,19 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "gsd-trae",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "GSD (Get Shit Done) framework adapter for Trae IDE",
|
|
5
5
|
"main": "bin/cli.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"gsd-trae": "bin/cli.js"
|
|
8
8
|
},
|
|
9
9
|
"scripts": {
|
|
10
|
-
"
|
|
10
|
+
"lint": "npx prettier --write README.md"
|
|
11
11
|
},
|
|
12
12
|
"keywords": [
|
|
13
13
|
"gsd",
|
|
14
14
|
"trae",
|
|
15
|
+
"gsd-trae",
|
|
16
|
+
"get-shit-done-trae",
|
|
15
17
|
"ai",
|
|
16
18
|
"workflow",
|
|
17
19
|
"project-management"
|
package/.trae/project_rules.md
DELETED
|
@@ -1,56 +0,0 @@
|
|
|
1
|
-
# AGENTS.md
|
|
2
|
-
|
|
3
|
-
面向 AI 编程助手的项目级指导文档(基于 GSD 框架)。
|
|
4
|
-
|
|
5
|
-
## 可用资源
|
|
6
|
-
|
|
7
|
-
`.planning/` 中的所有资源均可调用或引用:
|
|
8
|
-
|
|
9
|
-
### 智能助手(Agents)
|
|
10
|
-
|
|
11
|
-
| 助手 | 文件 | 用途 |
|
|
12
|
-
|------|------|---------|
|
|
13
|
-
| `@project-researcher` | `agents/gsd-project-researcher.md` | 研究领域生态系统 |
|
|
14
|
-
| `@research-synthesizer` | `agents/gsd-research-synthesizer.md` | 综合研究成果 |
|
|
15
|
-
| `@roadmapper` | `agents/gsd-roadmapper.md` | 创建项目路线图 |
|
|
16
|
-
| `@planner` | `agents/gsd-planner.md` | 创建阶段计划 |
|
|
17
|
-
| `@phase-researcher` | `agents/gsd-phase-researcher.md` | 研究阶段实现方案 |
|
|
18
|
-
| `@plan-checker` | `agents/gsd-plan-checker.md` | 验证计划是否达成目标 |
|
|
19
|
-
| `@executor` | `agents/gsd-executor.md` | 执行阶段计划 |
|
|
20
|
-
| `@verifier` | `agents/gsd-verifier.md` | 验证阶段完成情况 |
|
|
21
|
-
| `@debugger` | `agents/gsd-debugger.md` | 系统化调试 |
|
|
22
|
-
| `@codebase-mapper` | `agents/gsd-codebase-mapper.md` | 映射现有代码库 |
|
|
23
|
-
| `@integration-checker` | `agents/gsd-integration-checker.md` | 验证跨阶段集成 |
|
|
24
|
-
|
|
25
|
-
### 工作流
|
|
26
|
-
|
|
27
|
-
通过 `/gsd:command` 触发:
|
|
28
|
-
|
|
29
|
-
| 工作流 | 文件 | 用途 |
|
|
30
|
-
|----------|------|---------|
|
|
31
|
-
| `/gsd:new-project` | `workflows/new-project.md` | 初始化新项目 |
|
|
32
|
-
| `/gsd:new-milestone` | `workflows/new-milestone.md` | 开始新里程碑 |
|
|
33
|
-
| `/gsd:discuss-phase` | `workflows/discuss-phase.md` | 收集阶段上下文 |
|
|
34
|
-
| `/gsd:plan-phase` | `workflows/plan-phase.md` | 创建阶段计划 |
|
|
35
|
-
| `/gsd:execute-phase` | `workflows/execute-phase.md` | 执行阶段计划 |
|
|
36
|
-
| `/gsd:verify-work` | `workflows/verify-work.md` | 验证交付物 |
|
|
37
|
-
| `/gsd:audit-milestone` | `workflows/audit-milestone.md` | 审计里程碑完成情况 |
|
|
38
|
-
| `/gsd:complete-milestone` | `workflows/complete-milestone.md` | 归档已完成的里程碑 |
|
|
39
|
-
| `/gsd:map-codebase` | `workflows/map-codebase.md` | 分析现有代码 |
|
|
40
|
-
| `/gsd:progress` | `workflows/progress.md` | 检查项目进度 |
|
|
41
|
-
| `/gsd:debug` | `workflows/execute-phase.md` | 系统化调试 |
|
|
42
|
-
| `/gsd:health` | `workflows/health.md` | 诊断规划健康状况 |
|
|
43
|
-
| `/gsd:settings` | `workflows/settings.md` | 配置工作流偏好 |
|
|
44
|
-
|
|
45
|
-
### 参考文档
|
|
46
|
-
|
|
47
|
-
| 参考 | 文件 | 内容 |
|
|
48
|
-
|-----------|------|---------|
|
|
49
|
-
| 提问技巧 | `references/questioning.md` | 深度提问技术 |
|
|
50
|
-
| UI 品牌 | `references/ui-brand.md` | 输出视觉规范 |
|
|
51
|
-
| 模型配置 | `references/model-profiles.md` | AI 模型选择 |
|
|
52
|
-
| 规划配置 | `references/planning-config.md` | 配置选项 |
|
|
53
|
-
| Git 集成 | `references/git-integration.md` | Git 工作流模式 |
|
|
54
|
-
| 测试驱动开发 | `references/tdd.md` | 测试驱动开发 |
|
|
55
|
-
| 检查点 | `references/checkpoints.md` | 检查点模式 |
|
|
56
|
-
| 验证策略 | `references/verification-patterns.md` | 验证策略 |
|