# loop-sdd

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

## Basic Information

- **Project Name**: loop-sdd
- **Description**: 这是一个基于 Loop Engineering 和 SDD、面向支持 `/goal` 能力的 Agent 工具的工程模板集合。

Code Loop 是技术栈无关的通用框架：Python 脚本负责状态和门禁，业务项目只需提供可直接执行的验收命令。Java、JavaScript/TypeScript、Python、Go、Rust、.NET、C/C++、前端、基础设施和混合仓库均可使用，不依赖任何特定
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Loop SDD

这是一个基于 Loop Engineering 和 SDD、面向支持 `/goal` 能力的 Agent 工具的工程模板集合。

Code Loop 是技术栈无关的通用框架：Python 脚本负责状态和门禁，业务项目只需提供可直接执行的验收命令。Java、JavaScript/TypeScript、Python、Go、Rust、.NET、C/C++、前端、基础设施和混合仓库均可使用，不依赖任何特定构建工具。

## Code Loop Framework

模板位于 `code-loop-framework/`，复制到业务项目时使用：

```text
code-loop-framework/AGENTS.md → 项目根目录 AGENTS.md
code-loop-framework/.agents/  → 项目根目录 .agents/
code-loop-framework/code-loop/ → 项目根目录 code-loop/
```

三个入口技能：

- `$sdd-loop-router`：根据变更状态路由流程。
- `$sdd-loop-propose`：确认并冻结 Target。
- `$sdd-loop-goal`：执行 SDD、编码、测试、审查和交接。

快速上手见：[quickstart.md](docs/code-loop-framework/quickstart.md)。

## 与 mattpocock/skills 的关系

本项目吸收了 [mattpocock/skills](https://github.com/mattpocock/skills/tree/main) 的核心工程思想和技能实践：

- 用 `grill-with-docs`、`domain-modeling` 澄清目标、术语和架构决策。
- 用 `to-spec`、`to-tickets` 把讨论收敛为规格和带阻塞关系的任务。
- 用 `implement`、`tdd` 按垂直切片和红—绿循环实现。
- 用 `diagnosing-bugs` 建立紧反馈回路，拒绝没有复现信号的猜测式修复。
- 用 `code-review` 分开执行 Standards 和 Spec 两条审查轴。

Code Loop 在此基础上增加了自己的编排层：

1. `$sdd-loop-propose` 先试跑机器验收命令，再把 Target、历史失败基线和一次性执行授权冻结。
2. `$sdd-loop-goal` 使用当前 Agent 实际提供的 `/goal` 或等价持久 Goal 能力在冻结权限内持续执行，对比 fixed point/HEAD 失败指纹，并推进到真实终态包。
3. `code-loop/changes/<change-name>/` 统一保存 Spec、Tasks、Logs、Evidence、Reviews 和 Final Report。
4. 通过 Target 哈希、循环预算、分支模式和终态规则限制自动化边界。

模板已经把 Code Loop 所需的核心依赖技能复制到 `.agents/skills/`，因此不需要额外执行 `/setup-matt-pocock-skills`。如果要使用上游项目的 Issue Tracker、Wayfinder 或其他外部流程，再按上游说明单独配置。

## 文档

- [Code Loop 框架说明](docs/code-loop-framework/README.md)
- [快速上手](docs/code-loop-framework/quickstart.md)
- [上手操作手册](docs/code-loop-framework/上手操作手册.md)
- [依赖技能清单](docs/code-loop-framework/依赖技能清单.md)
- [状态确认说明](docs/code-loop-framework/状态确认说明.md)
- [支撑场景](docs/Since.md)

## 主流 Agent 的 /goal 工具支持对比
| 工具 | 是否原生 /goal | 任务持久化 | 独立校验机制 | 开源属性 | 运行环境 |
|---|---|---|---|---|---|
| Claude Code | ✅ 内置 | 会话内有效 | 独立裁判小模型 | 闭源 | 终端 + 全 IDE 插件 |
| Codex CLI | ✅ 内置 | 会话内有效 | 客观日志 / 文件校验 | 闭源 | 终端 CLI |
| Hermes Agent | ✅ 内置 | 跨会话持久存储 | 多层防死循环校验 | 开源 | 终端 + 任务看板 |
| ZCode | ✅ 内置 | 项目级保存 | 多模型交叉验收 | 闭源 | 桌面 GUI |
| OpenCode | ⚙️ 插件开启 | 可配置持久化 | 自定义校验脚本 | 完全开源 | 终端 CLI |
| MiMo Code | ✅ 定制内置 | 企业级任务归档 | 双模型 Judge 校验 | 闭源（小米内用） | IDE + 终端 |

该表只用于选型参考，不能代替运行时检测。`$sdd-loop-goal` 只认当前会话实际暴露的 `/goal` 或等价持久 Goal 工具；插件未启用、命令不可见或只有普通对话/计划能力时均视为不支持，并会在修改工程状态前停止。