Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 2 additions & 10 deletions .githooks/pre-commit
Original file line number Diff line number Diff line change
Expand Up @@ -24,14 +24,10 @@ snapshot_managed_release_paths() {
"Codex/Skills/EN/AGENTS.md"
"Claude/Skills/CN/CLAUDE.md"
"Claude/Skills/EN/CLAUDE.md"
"TraeCn/Skills/CN/user_rules/sopify.md"
"TraeCn/Skills/EN/user_rules/sopify.md"
"Codex/Skills/CN/skills/sopify"
"Codex/Skills/EN/skills/sopify"
"Claude/Skills/CN/skills/sopify"
"Claude/Skills/EN/skills/sopify"
"TraeCn/Skills/CN/skills/sopify"
"TraeCn/Skills/EN/skills/sopify"
)
local path
local src
Expand Down Expand Up @@ -93,7 +89,7 @@ trap on_exit EXIT
is_release_relevant_file() {
local path="$1"
case "$path" in
runtime/*|installer/*|Codex/Skills/*|Claude/Skills/*|TraeCn/Skills/*|README.md|README.zh-CN.md|CHANGELOG.md)
runtime/*|installer/*|Codex/Skills/*|Claude/Skills/*|README.md|README.zh-CN.md|CHANGELOG.md)
return 0
;;
scripts/sopify_runtime.py|scripts/go_plan_runtime.py|scripts/model_compare_runtime.py|scripts/clarification_bridge_runtime.py|scripts/decision_bridge_runtime.py|scripts/develop_checkpoint_runtime.py|scripts/sync-runtime-assets.sh|scripts/check-runtime-smoke.sh|scripts/release-sync.sh|scripts/release-preflight.sh|scripts/sync-skills.sh|scripts/check-skills-sync.sh|scripts/check-version-consistency.sh)
Expand Down Expand Up @@ -164,14 +160,10 @@ git -C "$ROOT_DIR" add \
Codex/Skills/EN/AGENTS.md \
Claude/Skills/CN/CLAUDE.md \
Claude/Skills/EN/CLAUDE.md \
TraeCn/Skills/CN/user_rules/sopify.md \
TraeCn/Skills/EN/user_rules/sopify.md \
Codex/Skills/CN/skills/sopify \
Codex/Skills/EN/skills/sopify \
Claude/Skills/CN/skills/sopify \
Claude/Skills/EN/skills/sopify \
TraeCn/Skills/CN/skills/sopify \
TraeCn/Skills/EN/skills/sopify
Claude/Skills/EN/skills/sopify

cat >"$STATE_FILE" <<EOF
RELEASE_VERSION=$RELEASE_VERSION
Expand Down
4 changes: 2 additions & 2 deletions .sopify-skills/blueprint/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

<!-- sopify:auto:focus:start -->
- 当前活动 plan:暂无。
- history 归档:已可用;最近归档为 `../history/2026-04/20260403_plan-a-risk-adaptive-interruption`
- history 归档:已可用;最近归档见 [变更历史索引](../history/index.md)
<!-- sopify:auto:focus:end -->

## 深入阅读入口
Expand All @@ -26,5 +26,5 @@
- [蓝图任务](./tasks.md)
- [Skill 标准对齐蓝图](./skill-standards-refactor.md)
- [变更历史](../history/index.md)
- 最近归档:`../history/2026-04/20260403_plan-a-risk-adaptive-interruption`
- 最近归档见 [变更历史索引](../history/index.md)
<!-- sopify:auto:read-next:end -->
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,13 @@
plan_id: 20260413_trae_host_adapter
feature_key: trae_host_adapter
level: standard
lifecycle_state: active
lifecycle_state: archived
knowledge_sync:
project: review
background: review
design: review
tasks: review
archive_ready: false
project: skip
background: skip
design: skip
tasks: skip
archive_ready: true
---

# 任务清单: Sopify 适配 Trae CN 宿主
Expand Down
1 change: 1 addition & 0 deletions .sopify-skills/history/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@
- `2026-03-21` ~~`20260320_cursor_plugin_install`~~ - abandoned - Cursor 插件安装(on_hold,路线未定,2026-04 主动弃置)
- `2026-03-24` [`20260324_task`](2026-03/20260324_task/) - standard - Steering: 从 HelloAGENTS/Superpowers 对比收口 Sopify 学习路径(E.1-E.3 全完成)
- `2026-03-26` [`20260326_5-plan-20260326-phase1-2-3-plan-plan-20260326-ph`](2026-03/20260326_5-plan-20260326-phase1-2-3-plan-plan-20260326-ph/) - standard - B1 文档收口后的实施与验证(全部 79 任务完成)
- `2026-04-27` ~~[`20260413_trae_host_adapter`](2026-04/20260413_trae_host_adapter/)~~ - retired - Trae CN 宿主适配(Phase 1-2 已完成,宿主面已退役)
- `2026-04-12` [`20260403_plan-a-risk-adaptive-interruption`](2026-04/20260403_plan-a-risk-adaptive-interruption/) - standard - Plan A 子计划:风险自适应打断与局部语义收敛
- `2026-03-28` [`20260327_hotfix`](2026-03/20260327_hotfix/) - standard - 状态机 Hotfix(B1 前置门禁)
- `2026-03-26` [`20260326_planning-materialization-decoupling`](2026-03/20260326_planning-materialization-decoupling/) - standard - 规划流程与方案包物化解耦
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@ Sopify 的核心价值是让 AI 编程工作流 **自适应推进、状态可交
| **质量验证** | gate / pipeline_hooks / CrossReview 等机制让关键执行和产出审查可验证 |
| **项目资产沉淀** | plan / review / history / blueprint 让计划、审查和历史可追踪、可复用 |
| **集成优质工具** | graphify(蓝图初始化)、cross-review(代码评审)等,默认按需启用/可配置关闭 |
| **多宿主** | 同一内核优先跑在 Claude Code / Codex,QCoder / Copilot 走调研接入,Trae CN 按 ADR-018 sunset |
| **多宿主** | 同一内核优先跑在 Claude Code / Codex,QCoder / Copilot 走调研接入,retired legacy host surface 已按 ADR-018 退出活跃目标 |
| **轻量可插拔** | 内核精简,工具以 plugin 形式接入,维护者可低成本集成新工具 |

**用户感知层:**
Expand Down Expand Up @@ -329,7 +329,7 @@ spec-kit/

本方案包(`20260424_lightweight_pluggable_architecture`)是 Sopify 项目当前的**总纲方案包**,统一管辖以下相关子任务包。所有活跃子任务包的方向必须服务于或不阻碍总纲目标;sunset 子任务包按 ADR-018 进入清理链路。

总纲目标:Sopify 从 "runtime 编排一切" → "runtime 只做 gate + state + contract,LLM 读 skill 自编排",同时保证多宿主原生支持(Claude Code / Codex ✅ 深度验证;QCoder / Copilot 📋 待调研;Trae CN 🔴 Sunset)。
总纲目标:Sopify 从 "runtime 编排一切" → "runtime 只做 gate + state + contract,LLM 读 skill 自编排",同时保证多宿主原生支持(Claude Code / Codex ✅ 深度验证;QCoder / Copilot 📋 待调研;retired legacy host surface 已归档)。

### 子任务包映射

Expand All @@ -339,7 +339,7 @@ spec-kit/
| 感知层精度 | `20260417_ux_perception_tuning` | Phase 0.2 | 前置基础改善 |
| CrossReview v0 核心 | `20260418_cross_review_engine` | Phase 4 前置依赖 | 独立产品线,并行推进 |
| Blueprint Graphify 增强 | `20260416_blueprint_graphify_integration` | Phase 5 基础设施 | 增强器架构,并行推进 |
| Trae CN 宿主适配 | `20260413_trae_host_adapter` | 多宿主扩展 | ADR-018 sunset;归档经验,不再作为 Phase 3 验证环境 |
| Legacy host adapter | archived legacy host adapter plan | 多宿主扩展 | ADR-018 sunset;归档经验,不再作为 Phase 3 验证环境 |

### 旧总纲残余吸收

Expand Down Expand Up @@ -390,11 +390,11 @@ spec-kit/
- 两者互补:20260416 提供自动化基础设施,Phase 5 提供用户面能力
- 可以独立推进,不依赖 engine 拆分

#### 独立线: `20260413_trae_host_adapter` — Trae CN 🔴 Sunset
#### 独立线: archived legacy host adapter — Retired Surface

与总纲方向:✅ 已按 ADR-018 降级
- 宿主适配层(installer, hosts adapter)独立于 engine/skill 层
- Trae CN 从活跃多宿主目标降为 sunset surface,不再作为 Phase 3 验证环境
- retired legacy host 从活跃多宿主目标降为 sunset surface,不再作为 Phase 3 验证环境
- 既有适配经验归档到 history/,作为后续 HostAdapter / HostCapability / HostRegistration 的历史参考
- 后续目标宿主优先 QCoder、GitHub Copilot,调研后各自独立立项
- 每个新宿主适配参考三层抽象 (HostAdapter + HostCapability + HostRegistration)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -117,7 +117,7 @@ Sopify 是 AI 编程工作流的 **control plane**,不是通用 LLM orchestrat
5. **向后兼容** — skill.yaml v1 继续工作,新字段可选
6. **Cross-review 分阶段验证** — 先 advisory,验证价值后升级 runtime
7. **子任务包方向一致** — 所有子任务包必须服务于或不阻碍总纲目标
8. **多宿主原生支持** — Claude Code / Codex (✅ 深度验证);QCoder / Copilot (📋 待调研);Trae CN (🔴 Sunset, ADR-018)
8. **多宿主原生支持** — Claude Code / Codex (✅ 深度验证);QCoder / Copilot (📋 待调研);retired legacy host surface 已按 ADR-018 退出活跃目标
9. **策展集成** — Plugin 面向维护者集成,用户配置开关控制
10. **pipeline_hooks 默认关闭** — 心流优先
11. **Action schema boundary** — LLM 可理解自然语言并提出结构化 action;Core/Validator 只依据 action schema、机器事实、side_effect 与风险策略授权,不维护用户话术白名单
Expand Down Expand Up @@ -223,19 +223,19 @@ host_support: ["*"]
└──────────────────────────────────────────────────────┘
```

> `TraeCn/` 属于 ADR-018 sunset surface,保留至 T-cleanup-2 执行,不作为新宿主提示层示例
> Retired legacy host prompt mirror 属于 ADR-018 sunset surface,清理后不作为新宿主提示层示例

### 5.2 当前宿主支持

| 宿主 | 状态 | 适配层 |
|------|------|-------|
| Claude Code | ✅ 深度验证 | `~/.claude/` |
| Codex | ✅ 深度验证 | `~/.codex/` |
| Trae CN | 🔴 Sunset (ADR-018) | `~/.trae-cn/` (归档) |
| Retired legacy host | 🔴 Sunset (ADR-018) | archived |
| QCoder | 📋 待调研 | 待确定 |
| GitHub Copilot | 📋 待调研 | 待确定 |

**新宿主适配**:参考 `20260413_trae_host_adapter` 归档后的三层抽象经验,在 `installer/hosts/` 下新建文件。适配清单:Phase 0 调研 (全局配置/规则注入/技能发现) → Phase 1 注册 → Phase 2 提示层 → Phase 3 验证。
**新宿主适配**:参考 archived legacy host adapter 的三层抽象经验,在 `installer/hosts/` 下新建文件。适配清单:Phase 0 调研 (全局配置/规则注入/技能发现) → Phase 1 注册 → Phase 2 提示层 → Phase 3 验证。

**skill.yaml 宿主兼容声明**:`host_support: ["*"]` (全宿主) 或指定宿主 ID。`skill_registry.py` 按当前宿主过滤。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@
| `20260417_ux_perception_tuning` | Phase 0.2 | 活跃 (B/C) | `plan/20260417_ux_perception_tuning/` |
| `20260418_cross_review_engine` | Phase 4 前置 | 已确认 | `plan/20260418_cross_review_engine/` |
| `20260416_blueprint_graphify_integration` | Phase 5 基础 | 基础集成活跃;Plugin 封装延后 | `plan/20260416_blueprint_graphify_integration/` |
| `20260413_trae_host_adapter` | 多宿主扩展 | Sunset (ADR-018) | `plan/20260413_trae_host_adapter/` |
| archived legacy host adapter | 多宿主扩展 | Sunset (ADR-018) | `history/2026-04/` |

## 旧总纲吸收记录

Expand Down Expand Up @@ -157,11 +157,11 @@ CR v0 release gate 通过 → Sopify Phase 4a → dogfood 数据 → 决定 Phas
|------|------|---------|
| Claude Code | ✅ 深度验证 | — |
| Codex | ✅ 深度验证 | — |
| Trae CN | 🔴 Sunset (ADR-018) | `20260413_trae_host_adapter` → history/ 归档 |
| Retired legacy host | 🔴 Sunset (ADR-018) | history/ 归档 |
| QCoder | 📋 待调研 | 调研后独立立项 |
| GitHub Copilot | 📋 待调研 | 调研后独立立项 |

新宿主适配参考三层抽象 (HostAdapter + HostCapability + HostRegistration),见 design.md §5。Trae 适配经验保留在 history/ 归档中供参考。
新宿主适配参考三层抽象 (HostAdapter + HostCapability + HostRegistration),见 design.md §5。retired legacy host 适配经验保留在 history/ 归档中供参考。

---

Expand Down Expand Up @@ -194,28 +194,28 @@ CR v0 release gate 通过 → Sopify Phase 4a → dogfood 数据 → 决定 Phas
- **依赖:** 无
- **估计:** 0.5 天

### T-cleanup-2:Trae Surface Sunset
### T-cleanup-2:Legacy Host Surface Retirement

- **行动(顺序遵循 ADR-018 §8 删除顺序):**
1. 从 `installer/hosts/__init__.py` 注册表中移除 trae_cn(CI dry-run)
2. 移除 `tests/test_installer.py` / `test_installer_status_doctor.py` / `test_release_hooks.py` 中 trae_cn 测试用例
3. 更新 `scripts/check-readme-links.py` / `check-skills-sync.sh` / `check-version-consistency.sh` / `sync-skills.sh` / `.githooks/pre-commit` 跳过 trae
4. 移除 `installer/hosts/trae_cn.py`
5. 移除 `TraeCn/` 整个目录
6. 归档 `.sopify-skills/plan/20260413_trae_host_adapter/` → `.sopify-skills/history/2026-04/`
7. 编辑 README.md / README.zh-CN.md / CONTRIBUTING.md / CONTRIBUTING_CN.md 移除 Trae 引用
1. 从 `installer/hosts/__init__.py` 注册表中移除 retired host(CI dry-run)
2. 移除 installer / status / release hook 中 retired host 测试用例
3. 更新 README link、skills sync、version consistency、syncpre-commit 脚本,停止扫描 retired host prompt mirror
4. 移除 retired host adapter 实现
5. 移除 retired host prompt mirror
6. 归档 retired host adapter plan → `.sopify-skills/history/2026-04/`
7. 编辑 README.md / README.zh-CN.md / CONTRIBUTING.md / CONTRIBUTING_CN.md 移除 retired host 引用
8. CHANGELOG.md 保留历史记录,只在最新版本添加 sunset 说明
- **依赖:** T-cleanup-1
- **验证:** CI 全量通过;grep -ri "trae" 仅返回 CHANGELOG 和 history/ 中的归档记录
- **验证:** CI 全量通过;retired host literal 仅返回 CHANGELOG 和 history/ 中的归档记录
- **估计:** 1 天

### T-cleanup-3:总纲与文档同步

- **行动:**
1. 更新总纲 design.md / tasks.md / background.md 中的宿主列表(确认 sunset 口径一致)
2. 确认 CI 全量通过,grep -ri "trae" 仅返回 CHANGELOG 和 history/
2. 确认 CI 全量通过,retired host literal 仅返回 CHANGELOG 和 history/
- **依赖:** T-cleanup-2
- **验证:** CI 全量通过,grep -ri "trae" 仅返回 CHANGELOG 和 history/ 中的归档记录
- **验证:** CI 全量通过,retired host literal 仅返回 CHANGELOG 和 history/ 中的归档记录
- **估计:** 0.5 天

### T-cleanup-4:install-sopify.sh 评估
Expand Down Expand Up @@ -251,7 +251,7 @@ P0 任务必须增强至少一项核心能力:adaptive route/workflow、state
| Phase 2 | 3 种复杂度工作流手动验证 |
| Phase 3 | v2 解析无报错,v1 兼容,host_support 多宿主验证(Claude + Codex baseline) |
| Phase 4b | 冻结,仅在启动条件满足后评审 |
| ADR-018 cleanup | Trae sunset 完成(grep -ri "trae" 仅返回 CHANGELOG + history/)|
| ADR-018 cleanup | legacy host sunset 完成(retired host literal 仅返回 CHANGELOG + history/)|
| 多宿主 | QCoder/Copilot 完成调研 |

---
Expand Down
104 changes: 104 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,110 @@ This changelog is maintained manually (not auto-generated).

## [Unreleased]

## [2026-04-27.163354] - 2026-04-27

### Docs

- Refined public documentation:
- `CONTRIBUTING.md`
- `CONTRIBUTING_CN.md`
- `README.md`
- `README.zh-CN.md`

### Scripts

- Adjusted maintenance scripts:
- `scripts/check-readme-links.py`
- `scripts/check-skills-sync.sh`
- `scripts/check-version-consistency.sh`
- `scripts/sync-skills.sh`

### Skills

- Synced prompt-layer skills:
- `Claude/Skills/CN/CLAUDE.md`
- `Claude/Skills/EN/CLAUDE.md`
- `Codex/Skills/CN/AGENTS.md`
- `Codex/Skills/EN/AGENTS.md`

### Tests

- Updated automated coverage:
- `tests/test_check_readme_links.py`
- `tests/test_installer.py`
- `tests/test_installer_status_doctor.py`
- `tests/test_release_hooks.py`

### Changed

- Updated project files:
- `.githooks/pre-commit`
- `CHANGELOG.md`
- `TraeCn/Skills/CN/skills/sopify/analyze/SKILL.md`
- `TraeCn/Skills/CN/skills/sopify/analyze/assets/question-output.md`
- `TraeCn/Skills/CN/skills/sopify/analyze/assets/success-output.md`
- `TraeCn/Skills/CN/skills/sopify/analyze/references/analyze-rules.md`
- `TraeCn/Skills/CN/skills/sopify/analyze/scripts/score_requirement.py`
- `TraeCn/Skills/CN/skills/sopify/design/SKILL.md`
- `TraeCn/Skills/CN/skills/sopify/design/assets/adr-template.md`
- `TraeCn/Skills/CN/skills/sopify/design/assets/background-template.md`
- `TraeCn/Skills/CN/skills/sopify/design/assets/design-template.md`
- `TraeCn/Skills/CN/skills/sopify/design/assets/output-summary.md`
- `TraeCn/Skills/CN/skills/sopify/design/assets/plan-light-template.md`
- `TraeCn/Skills/CN/skills/sopify/design/assets/tasks-template.md`
- `TraeCn/Skills/CN/skills/sopify/design/references/design-rules.md`
- `TraeCn/Skills/CN/skills/sopify/design/scripts/select_plan_level.py`
- `TraeCn/Skills/CN/skills/sopify/develop/SKILL.md`
- `TraeCn/Skills/CN/skills/sopify/develop/assets/output-partial.md`
- `TraeCn/Skills/CN/skills/sopify/develop/assets/output-quick-fix.md`
- `TraeCn/Skills/CN/skills/sopify/develop/assets/output-success.md`
- `TraeCn/Skills/CN/skills/sopify/develop/references/develop-rules.md`
- `TraeCn/Skills/CN/skills/sopify/develop/scripts/extract_pending_tasks.py`
- `TraeCn/Skills/CN/skills/sopify/kb/SKILL.md`
- `TraeCn/Skills/CN/skills/sopify/model-compare/SKILL.md`
- `TraeCn/Skills/CN/skills/sopify/templates/SKILL.md`
- `TraeCn/Skills/CN/skills/sopify/workflow-learning/CHANGELOG.md`
- `TraeCn/Skills/CN/skills/sopify/workflow-learning/SKILL.md`
- `TraeCn/Skills/CN/user_rules/sopify.md`
- `TraeCn/Skills/EN/skills/sopify/analyze/SKILL.md`
- `TraeCn/Skills/EN/skills/sopify/analyze/assets/question-output.md`
- `TraeCn/Skills/EN/skills/sopify/analyze/assets/success-output.md`
- `TraeCn/Skills/EN/skills/sopify/analyze/references/analyze-rules.md`
- `TraeCn/Skills/EN/skills/sopify/analyze/scripts/score_requirement.py`
- `TraeCn/Skills/EN/skills/sopify/design/SKILL.md`
- `TraeCn/Skills/EN/skills/sopify/design/assets/adr-template.md`
- `TraeCn/Skills/EN/skills/sopify/design/assets/background-template.md`
- `TraeCn/Skills/EN/skills/sopify/design/assets/design-template.md`
- `TraeCn/Skills/EN/skills/sopify/design/assets/output-summary.md`
- `TraeCn/Skills/EN/skills/sopify/design/assets/plan-light-template.md`
- `TraeCn/Skills/EN/skills/sopify/design/assets/tasks-template.md`
- `TraeCn/Skills/EN/skills/sopify/design/references/design-rules.md`
- `TraeCn/Skills/EN/skills/sopify/design/scripts/select_plan_level.py`
- `TraeCn/Skills/EN/skills/sopify/develop/SKILL.md`
- `TraeCn/Skills/EN/skills/sopify/develop/assets/output-partial.md`
- `TraeCn/Skills/EN/skills/sopify/develop/assets/output-quick-fix.md`
- `TraeCn/Skills/EN/skills/sopify/develop/assets/output-success.md`
- `TraeCn/Skills/EN/skills/sopify/develop/references/develop-rules.md`
- `TraeCn/Skills/EN/skills/sopify/develop/scripts/extract_pending_tasks.py`
- `TraeCn/Skills/EN/skills/sopify/kb/SKILL.md`
- `TraeCn/Skills/EN/skills/sopify/model-compare/SKILL.md`
- `TraeCn/Skills/EN/skills/sopify/templates/SKILL.md`
- `TraeCn/Skills/EN/skills/sopify/workflow-learning/CHANGELOG.md`
- `TraeCn/Skills/EN/skills/sopify/workflow-learning/SKILL.md`
- `TraeCn/Skills/EN/user_rules/sopify.md`
- `installer/hosts/__init__.py`
- `installer/hosts/trae_cn.py`

## [2026-04-27.163000] - 2026-04-27

### Removed

- Retired the Trae CN host surface:
- removed the `trae-cn:*` install target and host adapter
- removed the `TraeCn/` prompt-layer mirror
- removed Trae-specific sync, release, status/doctor, README, and installer test coverage
- archived the former Trae CN host adapter plan under `.sopify-skills/history/2026-04/`

## [2026-04-14.175552] - 2026-04-14

### Docs
Expand Down
Loading
Loading