# spec_expr

**Repository Path**: alienity/spec_expr

## Basic Information

- **Project Name**: spec_expr
- **Description**: 分享agent使用经验
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-10
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 编程助手通用规范

> 本规范适用于 Claude Code / OpenCode / QwenCode 等 AI 编程助手

---

## 核心机制

### 1. 任务前三问

| 问题 | 对应文件 | 目的 |
|------|----------|------|
| 做什么？优先级？ | `plan-registry.md` | 确认范围 |
| 有什么约束？边界？ | `spec-registry.md` | 理解规则 |
| 当前状态？ | `development-registry.md` | 避免冲突 |

### 2. 任务后两件事

| 动作 | 对应文件 | 目的 |
|------|----------|------|
| 更新状态 | `development-registry.md` | 保持信息新鲜 |
| 对照自检 | `validation-registry.md` | 确保交付质量 |

---

## Registry 文件说明

| 文件 | 作用 | 何时创建 |
|------|------|----------|
| `plan-registry.md` | 管理任务优先级和范围 | 多任务并行时 |
| `spec-registry.md` | 定义模块边界和约束 | 多模块协同时 |
| `development-registry.md` | 跟踪开发状态 | 需要避免冲突时 |
| `test-registry.md` | 定义测试要求 | 有质量要求时 |
| `validation-registry.md` | 定义交付标准 | 需要明确验收条件时 |

**原则**：有需要再创建，不为存在而存在。

---

## 快速开始

1. 查看 `TEMPLATE.md` 了解各 registry 的结构
2. 根据具体任务填充实际内容
3. 任务完成后更新状态

---

## 为什么有效？

> 这套规范的核心不是文档，而是**保持上下文同步**的机制。

- AI 的上下文是有限的 → 用 registry 压缩关键信息
- 多任务容易混乱 → 用 plan-registry 明确优先级
- 模块边界模糊 → 用 spec-registry 定义契约
- 完成标准不清 → 用 validation-registry 明确定义

---

## 使用说明

给 AI 助手任务时：

1. **首次任务**: 告诉它「先读 `.ai/` 下的对应文件」
   - Claude Code → `.ai/CLAUDE.md`
   - OpenCode → `.ai/OPENCODE.md`
   - QwenCode → `.ai/QWENCODE.md`
2. **有规范时**: 它会按 registry 执行
3. **无规范时**: 它会询问你需求再开始

**适用于任何 AI 编程助手**，因为核心是通用的上下文管理机制。