Appearance
术语表
核心概念
| 术语 | 全称 | 说明 |
|---|---|---|
| SDD | Spec-Driven Development | 规范驱动开发。先写规范,再写代码,规范作为唯一的真相来源。 |
| TDD | Test-Driven Development | 测试驱动开发。先写测试,再写实现,通过红-绿-重构循环驱动代码质量。 |
| 绿地项目 | Greenfield Project | 从零开始的新项目,没有历史代码约束。 |
| 棕地项目 | Brownfield Project | 在已有代码库上开发,需要先理解现有结构再进行改动。 |
文档模型
| 术语 | 说明 |
|---|---|
| Spec | 规范文档。描述一个功能变更的完整设计,包含背景、目标、约束和实现方案。是 SDD 的核心产物。 |
| Proposal | 提案。Brainstorm 阶段的输出,描述要做什么以及为什么做,用于团队讨论和确认。 |
| Design | 设计。Proposal 确认后的详细技术设计,包含接口定义、数据结构、依赖关系等。 |
| Tasks | 任务列表。将 Design 拆解为可执行的原子任务,每个任务有明确的完成标准。 |
| OpenSpec Change | 一份从 Proposal → Design → Tasks → 实现 → 验证的完整变更记录。 |
工具与机制
| 术语 | 说明 |
|---|---|
| Slash Command | 斜杠命令。以 / 开头的 Claude Code 命令,如 /sillyspec:init。 |
| Command | 命令。Slash Command 的同义词,指一个可执行的指令单元。 |
| Skill | 技能。一组相关的 Commands 和上下文的集合,形成一个完整的工作流能力。SillySpec 本身就是一个 Skill。 |
| HANDOFF | 状态文件。.sillyspec/HANDOFF 文件记录当前工作状态,用于在 Claude Code 会话间保持上下文连续性。 |
| Wave | 波次。大任务拆分为多个执行波次,每个 Wave 包含一组相关的 Tasks。 |
运行时概念
| 术语 | 说明 |
|---|---|
| Subagent | 子代理。Claude Code 中由主代理派生出的独立执行单元,用于并行处理任务。每个 Subagent 有独立的上下文窗口。 |
| Phase Context | 阶段上下文。当前所处的工作阶段(如 brainstorm、propose、execute),影响可用命令和系统行为。 |