From bfef14bbf70d7c5d65d0f69ca2149b6537d20a35 Mon Sep 17 00:00:00 2001 From: Tom Boucher Date: Sat, 4 Apr 2026 08:28:04 -0400 Subject: [PATCH] docs: update all READMEs for v1.32.0 release Co-Authored-By: Claude Opus 4.6 --- README.ja-JP.md | 40 ++++++++++++++++++++++++++++------------ README.ko-KR.md | 38 ++++++++++++++++++++++++++++---------- README.md | 38 ++++++++++++++++++++++++++------------ README.pt-BR.md | 42 ++++++++++++++++++++++++++++++++---------- README.zh-CN.md | 46 +++++++++++++++++++++++++++++++++++----------- 5 files changed, 149 insertions(+), 55 deletions(-) diff --git a/README.ja-JP.md b/README.ja-JP.md index 2430b4724..f2ce9ec8c 100644 --- a/README.ja-JP.md +++ b/README.ja-JP.md @@ -4,12 +4,10 @@ [English](README.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md) · **日本語** -**Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae向けの軽量かつ強力なメタプロンプティング、コンテキストエンジニアリング、仕様駆動開発システム。** +**Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae、Cline向けの軽量かつ強力なメタプロンプティング、コンテキストエンジニアリング、仕様駆動開発システム。** **コンテキストロット（Claudeがコンテキストウィンドウを消費するにつれ品質が劣化する現象）を解決します。** -[**English**](README.md) | [**Português**](README.pt-BR.md) | [**简体中文**](docs/zh-CN/README.md) | [**日本語**](docs/ja-JP/README.md) - [![npm version](https://img.shields.io/npm/v/get-shit-done-cc?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/get-shit-done-cc) [![npm downloads](https://img.shields.io/npm/dm/get-shit-done-cc?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/get-shit-done-cc) [![Tests](https://img.shields.io/github/actions/workflow/status/gsd-build/get-shit-done/test.yml?branch=main&style=for-the-badge&logo=github&label=Tests)](https://github.com/gsd-build/get-shit-done/actions/workflows/test.yml) @@ -77,6 +75,16 @@ GSDはそれを解決します。Claude Codeを信頼性の高いものにする ビルトインの品質ゲートが本当の問題を検出します：スキーマドリフト検出はマイグレーション漏れのORM変更をフラグし、セキュリティ強制は検証を脅威モデルに紐付け、スコープ削減検出はプランナーが要件を暗黙的に落とすのを防止します。 +### v1.32.0 ハイライト + +- **STATE.md整合性ゲート** — `state validate`がSTATE.mdとファイルシステムの差分を検出、`state sync`が実際のプロジェクト状態から再構築 +- **`--to N`フラグ** — 自律実行を特定のフェーズ完了後に停止 +- **リサーチゲート** — RESEARCH.mdに未解決の質問がある場合、計画をブロック +- **検証マイルストーンスコープフィルタリング** — 後のフェーズで対処されるギャップは「ギャップ」ではなく「延期」としてマーク +- **読み取り後編集ガード** — 非Claudeランタイムでの無限リトライループを防止するアドバイザリーフック +- **コンテキスト削減** — Markdownのトランケーションとキャッシュフレンドリーなプロンプト順序でトークン使用量を削減 +- **4つの新ランタイム** — Trae、Kilo、Augment、Cline（合計12ランタイム） + --- ## はじめに @@ -86,20 +94,20 @@ npx get-shit-done-cc@latest ``` インストーラーが以下の選択を求めます： -1. **ランタイム** — Claude Code、OpenCode、Gemini、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Trae、またはすべて（インタラクティブ複数選択 — 1回のインストールセッションで複数のランタイムを選択可能） +1. **ランタイム** — Claude Code、OpenCode、Gemini、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae、Cline、またはすべて（インタラクティブ複数選択 — 1回のインストールセッションで複数のランタイムを選択可能） 2. **インストール先** — グローバル（全プロジェクト）またはローカル（現在のプロジェクトのみ） 確認方法： -- Claude Code / Gemini: `/gsd-help` -- OpenCode: `/gsd-help` -- Kilo: `/gsd-help` +- Claude Code / Gemini / Copilot / Antigravity: `/gsd-help` +- OpenCode / Kilo / Augment / Trae: `/gsd-help` - Codex: `$gsd-help` -- Copilot: `/gsd-help` -- Antigravity: `/gsd-help` -- Trae: `/gsd-help` +- Cline: GSDは`.clinerules`経由でインストール — `.clinerules`の存在を確認 > [!NOTE] -> Codexのインストールでは、カスタムプロンプトではなくスキル（`skills/gsd-*/SKILL.md`）を使用します。 +> Claude Code 2.1.88+とCodexはスキル（`skills/gsd-*/SKILL.md`）としてインストールされます。Clineは`.clinerules`を使用します。インストーラーがすべての形式を自動的に処理します。 + +> [!TIP] +> ソースベースのインストールやnpmが利用できない環境については、**[docs/manual-update.md](docs/manual-update.md)**を参照してください。 ### 最新の状態を保つ @@ -143,16 +151,24 @@ npx get-shit-done-cc --cursor --local # ./.cursor/ にインストール npx get-shit-done-cc --antigravity --global # ~/.gemini/antigravity/ にインストール npx get-shit-done-cc --antigravity --local # ./.agent/ にインストール +# Augment +npx get-shit-done-cc --augment --global # ~/.augment/ にインストール +npx get-shit-done-cc --augment --local # ./.augment/ にインストール + # Trae（ByteDance、スキルファースト） npx get-shit-done-cc --trae --global # ~/.trae/ にインストール npx get-shit-done-cc --trae --local # ./.trae/ にインストール +# Cline（.clinerules使用） +npx get-shit-done-cc --cline --global # ~/.cline/ にインストール +npx get-shit-done-cc --cline --local # ./.clinerules にインストール + # 全ランタイム npx get-shit-done-cc --all --global # すべてのディレクトリにインストール ``` `--global`（`-g`）または `--local`（`-l`）でインストール先の質問をスキップできます。 -`--claude`、`--opencode`、`--gemini`、`--kilo`、`--codex`、`--copilot`、`--cursor`、`--windsurf`、`--antigravity`、`--trae`、または `--all` でランタイムの質問をスキップできます。 +`--claude`、`--opencode`、`--gemini`、`--kilo`、`--codex`、`--copilot`、`--cursor`、`--windsurf`、`--antigravity`、`--augment`、`--trae`、`--cline`、または `--all` でランタイムの質問をスキップできます。 diff --git a/README.ko-KR.md b/README.ko-KR.md index 2c022cbf4..6f7a29624 100644 --- a/README.ko-KR.md +++ b/README.ko-KR.md @@ -4,7 +4,7 @@ [English](README.md) · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · **한국어** -**Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae를 위한 가볍고 강력한 메타 프롬프팅, 컨텍스트 엔지니어링, 스펙 기반 개발 시스템.** +**Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Cline을 위한 가볍고 강력한 메타 프롬프팅, 컨텍스트 엔지니어링, 스펙 기반 개발 시스템.** **컨텍스트 rot를 해결합니다 — Claude의 컨텍스트 창이 채워질수록 품질이 저하되는 문제.** @@ -75,6 +75,16 @@ GSD가 그걸 고칩니다. Claude Code를 신뢰할 수 있게 만드는 컨텍 내장 품질 게이트가 실제 문제를 잡아냅니다: 스키마 드리프트 감지는 마이그레이션 누락된 ORM 변경을 플래그하고, 보안 강제는 검증을 위협 모델에 고정시키고, 스코프 축소 감지는 플래너가 요구사항을 몰래 빠뜨리는 걸 방지합니다. +### v1.32.0 하이라이트 + +- **STATE.md 일관성 게이트** — `state validate`가 STATE.md와 파일시스템 간 드리프트를 감지, `state sync`가 실제 프로젝트 상태에서 재구성 +- **`--to N` 플래그** — 자율 실행을 특정 단계 완료 후 중지 +- **리서치 게이트** — RESEARCH.md에 미해결 질문이 있으면 기획을 차단 +- **검증 마일스톤 스코프 필터링** — 이후 단계에서 처리될 격차는 "격차"가 아닌 "지연됨"으로 표시 +- **읽기-후-편집 가드** — 비Claude 런타임에서 무한 재시도 루프를 방지하는 어드바이저리 훅 +- **컨텍스트 축소** — 마크다운 잘라내기 및 캐시 친화적 프롬프트 순서로 토큰 사용량 절감 +- **4개의 새 런타임** — Trae, Kilo, Augment, Cline (총 12개 런타임) + --- ## 시작하기 @@ -84,20 +94,20 @@ npx get-shit-done-cc@latest ``` 설치 중에 다음을 선택합니다: -1. **런타임** — Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Trae, 또는 전체 (대화형 다중 선택 — 한 번에 여러 런타임 선택 가능) +1. **런타임** — Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Cline, 또는 전체 (대화형 다중 선택 — 한 번에 여러 런타임 선택 가능) 2. **위치** — 전역 (모든 프로젝트) 또는 로컬 (현재 프로젝트만) 설치가 됐는지 확인하려면: -- Claude Code / Gemini: `/gsd-help` -- OpenCode: `/gsd-help` -- Kilo: `/gsd-help` +- Claude Code / Gemini / Copilot / Antigravity: `/gsd-help` +- OpenCode / Kilo / Augment / Trae: `/gsd-help` - Codex: `$gsd-help` -- Copilot: `/gsd-help` -- Antigravity: `/gsd-help` -- Trae: `/gsd-help` +- Cline: GSD는 `.clinerules`를 통해 설치 — `.clinerules` 존재 여부 확인 > [!NOTE] -> Codex 설치는 커스텀 프롬프트 대신 스킬(`skills/gsd-*/SKILL.md`)을 사용합니다. +> Claude Code 2.1.88+와 Codex는 스킬(`skills/gsd-*/SKILL.md`)로 설치됩니다. Cline은 `.clinerules`를 사용합니다. 설치 프로그램이 모든 형식을 자동으로 처리합니다. + +> [!TIP] +> 소스 기반 설치 또는 npm을 사용할 수 없는 환경은 **[docs/manual-update.md](docs/manual-update.md)**를 참조하세요. ### 업데이트 유지 @@ -141,16 +151,24 @@ npx get-shit-done-cc --cursor --local # ./.cursor/에 설치 npx get-shit-done-cc --antigravity --global # ~/.gemini/antigravity/에 설치 npx get-shit-done-cc --antigravity --local # ./.agent/에 설치 +# Augment +npx get-shit-done-cc --augment --global # ~/.augment/에 설치 +npx get-shit-done-cc --augment --local # ./.augment/에 설치 + # Trae (ByteDance, 스킬 우선) npx get-shit-done-cc --trae --global # ~/.trae/에 설치 npx get-shit-done-cc --trae --local # ./.trae/에 설치 +# Cline (.clinerules 사용) +npx get-shit-done-cc --cline --global # ~/.cline/에 설치 +npx get-shit-done-cc --cline --local # ./.clinerules에 설치 + # 전체 런타임 npx get-shit-done-cc --all --global # 모든 디렉터리에 설치 ``` 위치 프롬프트 건너뛰기: `--global` (`-g`) 또는 `--local` (`-l`). -런타임 프롬프트 건너뛰기: `--claude`, `--opencode`, `--gemini`, `--kilo`, `--codex`, `--copilot`, `--cursor`, `--windsurf`, `--antigravity`, `--trae`, 또는 `--all`. +런타임 프롬프트 건너뛰기: `--claude`, `--opencode`, `--gemini`, `--kilo`, `--codex`, `--copilot`, `--cursor`, `--windsurf`, `--antigravity`, `--augment`, `--trae`, `--cline`, 또는 `--all`. diff --git a/README.md b/README.md index aff764121..d048e705a 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,10 @@ -> [!WARNING] -> **WORKAROUND FOR MISSING NPM UNTIL WE CAN PUBLISH AGAIN** -> `npx get-shit-done-cc@latest` is currently unavailable. Install or update directly from source: -> ```bash -> git pull --rebase origin main && node scripts/build-hooks.js && node bin/install.js --claude --global -> ``` -> See **[docs/manual-update.md](docs/manual-update.md)** for full instructions and all runtime flags. -
# GET SHIT DONE **English** · [Português](README.pt-BR.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) -**A light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, and Augment.** +**A light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, and Cline.** **Solves context rot — the quality degradation that happens as Claude fills its context window.** @@ -83,6 +75,16 @@ People who want to describe what they want and have it built correctly — witho Built-in quality gates catch real problems: schema drift detection flags ORM changes missing migrations, security enforcement anchors verification to threat models, and scope reduction detection prevents the planner from silently dropping your requirements. +### v1.32.0 Highlights + +- **STATE.md consistency gates** — `state validate` detects drift between STATE.md and filesystem; `state sync` reconstructs from actual project state +- **`--to N` flag** — Stop autonomous execution after a specific phase +- **Research gate** — Blocks planning when RESEARCH.md has unresolved open questions +- **Verifier milestone scope filtering** — Gaps addressed in later phases marked as deferred, not gaps +- **Read-before-edit guard** — Advisory hook prevents infinite retry loops in non-Claude runtimes +- **Context reduction** — Markdown truncation and cache-friendly prompt ordering for lower token usage +- **4 new runtimes** — Trae, Kilo, Augment, and Cline (12 runtimes total) + --- ## Getting Started @@ -92,16 +94,20 @@ npx get-shit-done-cc@latest ``` The installer prompts you to choose: -1. **Runtime** — Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, or all (interactive multi-select — pick multiple runtimes in a single install session) +1. **Runtime** — Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Cline, or all (interactive multi-select — pick multiple runtimes in a single install session) 2. **Location** — Global (all projects) or local (current project only) Verify with: - Claude Code / Gemini / Copilot / Antigravity: `/gsd-help` - OpenCode / Kilo / Augment / Trae: `/gsd-help` - Codex: `$gsd-help` +- Cline: GSD installs via `.clinerules` — verify by checking `.clinerules` exists > [!NOTE] -> Claude Code 2.1.88+ and Codex install as skills (`skills/gsd-*/SKILL.md`). Older Claude Code versions use `commands/gsd/`. The installer handles this automatically. +> Claude Code 2.1.88+ and Codex install as skills (`skills/gsd-*/SKILL.md`). Older Claude Code versions use `commands/gsd/`. Cline uses `.clinerules` for configuration. The installer handles all formats automatically. + +> [!TIP] +> For source-based installs or environments where npm is unavailable, see **[docs/manual-update.md](docs/manual-update.md)**. ### Staying Updated @@ -157,12 +163,16 @@ npx get-shit-done-cc --augment --local # Install to ./.augment/ npx get-shit-done-cc --trae --global # Install to ~/.trae/ npx get-shit-done-cc --trae --local # Install to ./.trae/ +# Cline (uses .clinerules) +npx get-shit-done-cc --cline --global # Install to ~/.cline/ +npx get-shit-done-cc --cline --local # Install to ./.clinerules + # All runtimes npx get-shit-done-cc --all --global # Install to all directories ``` Use `--global` (`-g`) or `--local` (`-l`) to skip the location prompt. -Use `--claude`, `--opencode`, `--gemini`, `--kilo`, `--codex`, `--copilot`, `--cursor`, `--windsurf`, `--antigravity`, `--augment`, `--trae`, or `--all` to skip the runtime prompt. +Use `--claude`, `--opencode`, `--gemini`, `--kilo`, `--codex`, `--copilot`, `--cursor`, `--windsurf`, `--antigravity`, `--augment`, `--trae`, `--cline`, or `--all` to skip the runtime prompt. Use `--sdk` to also install the GSD SDK CLI (`gsd-sdk`) for headless autonomous execution. @@ -823,6 +833,8 @@ npx get-shit-done-cc --cursor --global --uninstall npx get-shit-done-cc --windsurf --global --uninstall npx get-shit-done-cc --antigravity --global --uninstall npx get-shit-done-cc --augment --global --uninstall +npx get-shit-done-cc --trae --global --uninstall +npx get-shit-done-cc --cline --global --uninstall # Local installs (current project) npx get-shit-done-cc --claude --local --uninstall @@ -835,6 +847,8 @@ npx get-shit-done-cc --cursor --local --uninstall npx get-shit-done-cc --windsurf --local --uninstall npx get-shit-done-cc --antigravity --local --uninstall npx get-shit-done-cc --augment --local --uninstall +npx get-shit-done-cc --trae --local --uninstall +npx get-shit-done-cc --cline --local --uninstall ``` This removes all GSD commands, agents, hooks, and settings while preserving your other configurations. diff --git a/README.pt-BR.md b/README.pt-BR.md index 6018f867a..fcdce9f0e 100644 --- a/README.pt-BR.md +++ b/README.pt-BR.md @@ -4,7 +4,7 @@ [English](README.md) · **Português** · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) -**Um sistema leve e poderoso de meta-prompting, engenharia de contexto e desenvolvimento orientado a especificação para Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment e Trae.** +**Um sistema leve e poderoso de meta-prompting, engenharia de contexto e desenvolvimento orientado a especificação para Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae e Cline.** **Resolve context rot — a degradação de qualidade que acontece conforme o Claude enche a janela de contexto.** @@ -73,6 +73,16 @@ Para quem quer descrever o que precisa e receber isso construído do jeito certo Quality gates embutidos capturam problemas reais: detecção de schema drift sinaliza mudanças ORM sem migrations, segurança ancora verificação a modelos de ameaça, e detecção de redução de escopo impede o planner de descartar requisitos silenciosamente. +### Destaques v1.32.0 + +- **Gates de consistência STATE.md** — `state validate` detecta divergência entre STATE.md e o filesystem; `state sync` reconstrói a partir do estado real do projeto +- **Flag `--to N`** — Para a execução autônoma após completar uma fase específica +- **Research gate** — Bloqueia planejamento quando RESEARCH.md tem perguntas abertas não resolvidas +- **Filtro de escopo do verificador** — Lacunas abordadas em fases posteriores são marcadas como "adiadas", não como lacunas +- **Guard de leitura antes de edição** — Hook consultivo previne loops de retry infinitos em runtimes não-Claude +- **Redução de contexto** — Truncamento de Markdown e ordenação de prompts cache-friendly para menor uso de tokens +- **4 novos runtimes** — Trae, Kilo, Augment e Cline (12 runtimes no total) + --- ## Primeiros passos @@ -82,20 +92,20 @@ npx get-shit-done-cc@latest ``` O instalador pede: -1. **Runtime** — Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Trae, ou todos +1. **Runtime** — Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Cline, ou todos 2. **Local** — Global (todos os projetos) ou local (apenas projeto atual) Verifique com: -- Claude Code / Gemini: `/gsd-help` -- OpenCode: `/gsd-help` -- Kilo: `/gsd-help` +- Claude Code / Gemini / Copilot / Antigravity: `/gsd-help` +- OpenCode / Kilo / Augment / Trae: `/gsd-help` - Codex: `$gsd-help` -- Copilot: `/gsd-help` -- Antigravity: `/gsd-help` -- Trae: `/gsd-help` +- Cline: GSD instala via `.clinerules` — verifique se `.clinerules` existe > [!NOTE] -> A instalação do Codex usa skills (`skills/gsd-*/SKILL.md`) em vez de prompts customizados. +> Claude Code 2.1.88+ e Codex instalam como skills (`skills/gsd-*/SKILL.md`). Cline usa `.clinerules`. O instalador lida com todos os formatos automaticamente. + +> [!TIP] +> Para instalação a partir do código-fonte ou ambientes sem npm, consulte **[docs/manual-update.md](docs/manual-update.md)**. ### Mantendo atualizado @@ -137,16 +147,24 @@ npx get-shit-done-cc --cursor --local npx get-shit-done-cc --antigravity --global npx get-shit-done-cc --antigravity --local +# Augment +npx get-shit-done-cc --augment --global # Install to ~/.augment/ +npx get-shit-done-cc --augment --local # Install to ./.augment/ + # Trae (ByteDance, skills-first) npx get-shit-done-cc --trae --global # Install to ~/.trae/ npx get-shit-done-cc --trae --local # Install to ./.trae/ +# Cline (usa .clinerules) +npx get-shit-done-cc --cline --global # Install to ~/.cline/ +npx get-shit-done-cc --cline --local # Install to ./.clinerules + # Todos npx get-shit-done-cc --all --global ``` Use `--global` (`-g`) ou `--local` (`-l`) para pular a pergunta de local. -Use `--claude`, `--opencode`, `--gemini`, `--kilo`, `--codex`, `--copilot`, `--cursor`, `--windsurf`, `--antigravity`, `--trae` ou `--all` para pular a pergunta de runtime. +Use `--claude`, `--opencode`, `--gemini`, `--kilo`, `--codex`, `--copilot`, `--cursor`, `--windsurf`, `--antigravity`, `--augment`, `--trae`, `--cline` ou `--all` para pular a pergunta de runtime. @@ -416,7 +434,9 @@ npx get-shit-done-cc --codex --global --uninstall npx get-shit-done-cc --copilot --global --uninstall npx get-shit-done-cc --cursor --global --uninstall npx get-shit-done-cc --antigravity --global --uninstall +npx get-shit-done-cc --augment --global --uninstall npx get-shit-done-cc --trae --global --uninstall +npx get-shit-done-cc --cline --global --uninstall # Instalações locais (projeto atual) npx get-shit-done-cc --claude --local --uninstall @@ -427,7 +447,9 @@ npx get-shit-done-cc --codex --local --uninstall npx get-shit-done-cc --copilot --local --uninstall npx get-shit-done-cc --cursor --local --uninstall npx get-shit-done-cc --antigravity --local --uninstall +npx get-shit-done-cc --augment --local --uninstall npx get-shit-done-cc --trae --local --uninstall +npx get-shit-done-cc --cline --local --uninstall ``` --- diff --git a/README.zh-CN.md b/README.zh-CN.md index b4d166d81..83584ffcb 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -2,9 +2,9 @@ # GET SHIT DONE -[English](README.md) · [Português](README.pt-BR.md) · **简体中文** · [日本語](README.ja-JP.md) +[English](README.md) · [Português](README.pt-BR.md) · **简体中文** · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) -**一个轻量但强大的元提示、上下文工程与规格驱动开发系统，适用于 Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor 和 Antigravity。** +**一个轻量但强大的元提示、上下文工程与规格驱动开发系统，适用于 Claude Code、OpenCode、Gemini CLI、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae 和 Cline。** **它解决的是 context rot：随着 Claude 的上下文窗口被填满，输出质量逐步劣化的问题。** @@ -73,6 +73,16 @@ GSD 解决的就是这个问题。它是让 Claude Code 变得可靠的上下文 适合那些想把自己的需求说明白，然后让系统正确构建出来的人，而不是假装自己在运营一个 50 人工程组织的人。 +### v1.32.0 亮点 + +- **STATE.md 一致性检查** — `state validate` 检测 STATE.md 与文件系统之间的偏差；`state sync` 从实际项目状态重建 +- **`--to N` 标志** — 在完成特定阶段后停止自主执行 +- **研究门控** — 当 RESEARCH.md 有未解决的开放问题时阻止规划 +- **验证里程碑范围过滤** — 后续阶段将处理的差距标记为"延迟"而非差距 +- **读取后编辑保护** — 咨询性 hook 防止非 Claude 运行时的无限重试循环 +- **上下文缩减** — Markdown 截断和缓存友好的 prompt 排序，降低 token 使用量 +- **4 个新运行时** — Trae、Kilo、Augment 和 Cline（共 12 个运行时） + --- ## 快速开始 @@ -82,20 +92,20 @@ npx get-shit-done-cc@latest ``` 安装器会提示你选择： -1. **运行时**：Claude Code、OpenCode、Gemini、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Trae，或全部 +1. **运行时**：Claude Code、OpenCode、Gemini、Kilo、Codex、Copilot、Cursor、Windsurf、Antigravity、Augment、Trae、Cline，或全部 2. **安装位置**：全局（所有项目）或本地（仅当前项目） 安装后可这样验证： -- Claude Code / Gemini：`/gsd-help` -- OpenCode：`/gsd-help` -- Kilo：`/gsd-help` +- Claude Code / Gemini / Copilot / Antigravity：`/gsd-help` +- OpenCode / Kilo / Augment / Trae：`/gsd-help` - Codex：`$gsd-help` -- Copilot：`/gsd-help` -- Antigravity：`/gsd-help` -- Trae：`/gsd-help` +- Cline：GSD 通过 `.clinerules` 安装 — 检查 `.clinerules` 是否存在 > [!NOTE] -> Codex 安装走的是 skill 机制（`skills/gsd-*/SKILL.md`），不是自定义 prompt。 +> Claude Code 2.1.88+ 和 Codex 以 skill 形式安装（`skills/gsd-*/SKILL.md`）。Cline 使用 `.clinerules`。安装器会自动处理所有格式。 + +> [!TIP] +> 基于源码安装或无法使用 npm 的环境，请参阅 **[docs/manual-update.md](docs/manual-update.md)**。 ### 保持更新 @@ -139,16 +149,24 @@ npx get-shit-done-cc --cursor --local # 安装到 ./.cursor/ npx get-shit-done-cc --antigravity --global # 安装到 ~/.gemini/antigravity/ npx get-shit-done-cc --antigravity --local # 安装到 ./.agent/ +# Augment +npx get-shit-done-cc --augment --global # 安装到 ~/.augment/ +npx get-shit-done-cc --augment --local # 安装到 ./.augment/ + # Trae（字节跳动，以 skills 为主） npx get-shit-done-cc --trae --global # 安装到 ~/.trae/ npx get-shit-done-cc --trae --local # 安装到 ./.trae/ +# Cline（使用 .clinerules） +npx get-shit-done-cc --cline --global # 安装到 ~/.cline/ +npx get-shit-done-cc --cline --local # 安装到 ./.clinerules + # 所有运行时 npx get-shit-done-cc --all --global # 安装到所有目录 ``` 使用 `--global`（`-g`）或 `--local`（`-l`）可以跳过安装位置提示。 -使用 `--claude`、`--opencode`、`--gemini`、`--kilo`、`--codex`、`--copilot`、`--cursor`、`--windsurf`、`--antigravity`、`--trae` 或 `--all` 可以跳过运行时提示。 +使用 `--claude`、`--opencode`、`--gemini`、`--kilo`、`--codex`、`--copilot`、`--cursor`、`--windsurf`、`--antigravity`、`--augment`、`--trae`、`--cline` 或 `--all` 可以跳过运行时提示。 @@ -758,6 +776,9 @@ npx get-shit-done-cc --codex --global --uninstall npx get-shit-done-cc --copilot --global --uninstall npx get-shit-done-cc --cursor --global --uninstall npx get-shit-done-cc --antigravity --global --uninstall +npx get-shit-done-cc --augment --global --uninstall +npx get-shit-done-cc --trae --global --uninstall +npx get-shit-done-cc --cline --global --uninstall # 本地安装（当前项目） npx get-shit-done-cc --claude --local --uninstall @@ -768,6 +789,9 @@ npx get-shit-done-cc --codex --local --uninstall npx get-shit-done-cc --copilot --local --uninstall npx get-shit-done-cc --cursor --local --uninstall npx get-shit-done-cc --antigravity --local --uninstall +npx get-shit-done-cc --augment --local --uninstall +npx get-shit-done-cc --trae --local --uninstall +npx get-shit-done-cc --cline --local --uninstall ``` 这会移除所有 GSD 命令、代理、hooks 和设置，但会保留你其他配置。