# harness-sdd

**Repository Path**: asahi_software/harness-sdd

## Basic Information

- **Project Name**: harness-sdd
- **Description**: 基于openspec和superpowers思想整合的 coding agent 端到端编码工作流
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-13
- **Last Updated**: 2026-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SDD Framework Clean Kit

这是渐进式 SDD + `sdd-auto-test` 的纯净版抽离包。它只包含通用流程、命令、技能、模板和脚本，不包含任何具体系统的业务规则、目录名、账号、端口或路由。

## 包含内容

```text
sdd-framework-clean/
├── AGENTS.md                         # 新项目 AGENTS 模板
├── .sdd-adapter.env.example          # 新项目适配配置模板
├── .trae/commands/                   # Trae 命令入口
├── .opencode/commands/               # OpenCode 命令入口
├── .agents/skills/sdd-auto-test/     # 通用自动化测试 skill
├── code-copilot/
│   ├── agents/                       # code-copilot agent 提示词
│   ├── changes/templates/            # spec/tasks/test-spec/log 模板
│   ├── knowledge/index.md            # 知识索引
│   ├── rules/                        # 通用规则模板
│   └── scripts/                      # 通用自动化测试脚本
├── docs/new-project-adaptation.md    # 新项目接入适配说明
└── install.sh                        # 复制到新项目的安装脚本
```

## 新项目接入

在新项目根目录执行：

```bash
/path/to/sdd-framework-clean/install.sh /path/to/new-project
```

然后进入新项目：

```bash
cp .sdd-adapter.env.example .sdd-adapter.env
```

编辑 `.sdd-adapter.env`，填写前后端目录、构建命令、服务地址、登录账号、登录选择器和巡检路由。详细说明见 [docs/new-project-adaptation.md](docs/new-project-adaptation.md)。

## 推荐流程

```text
/spec-init
-> /propose <需求>
-> /test <变更名> --plan
-> /apply <变更名> [--mode worktree|current]
-> /test <变更名> --auto
-> /fix <变更名> <问题>（按需）
-> /test <变更名> --auto --rerun-failed（按需）
-> /review <变更名>
-> /test <变更名> --补测（按需）
-> /archive <变更名>
-> /finish <变更名>
```

`/apply` 支持两种执行模式：

```text
/apply user-import                       # 默认 worktree 模式
/apply user-import --mode worktree       # 显式隔离模式
/apply user-import --mode current        # 当前分支和当前工作区模式
```

模式会写入变更 `log.md`，后续 `/test`、`/fix`、`/review`、`/archive`、`/finish` 必须沿用。`current` 不创建或切换分支，也不创建 worktree；提交、push 和 discard 仍需遵守项目规则及确认门禁。

## 纯净性约束

- 所有项目相关信息必须写入新项目自己的 `AGENTS.md`、`code-copilot/rules/` 或 `.sdd-adapter.env`。
- 不要在 `.agents/skills/sdd-auto-test/` 中写具体系统名称、业务状态、固定端口、账号或路由。
- 自动化测试产物只进入 `code-copilot/changes/<change>/auto-test/` 或 `code-copilot/auto-test-runs/`。