# 3r-dna

**Repository Path**: joyswing/3r

## Basic Information

- **Project Name**: 3r-dna
- **Description**:  3r-dna : Index-driven AI Cognitive Genome. Philosophy makes AI a partner; Governance makes it reliable. A
  protocol for verifiable, evolutionary engineering collaboration.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-02-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 3r-dna：任务前规划与决策约定

**定位**：3r 是**思维框架**——规范「如何思考」与「何时停手」，而不是替代思考或追求填表效率。工具服务于思考质量。

**实际用途**：在动手写代码或改系统前，用最少时间把「风险、验证、应对」想清楚；关键任务时产出可执行、可验收、可审计的规划（含反证路径、停止条件、证据等级），减少返工和盲目推进。

---

## 什么时候用

- 改数据库表结构、接口契约或核心逻辑
- 需求模糊、存在多种技术方案或影响多模块
- 安全/权限/密钥/数据相关，或需要留痕、复盘、交接
- 希望 AI 或团队按「同一份规划」执行且可验收

---

## 怎么用（两步选一）

| 场景 | 用法 | 产出 |
|------|------|------|
| 日常、想快速过一遍 | **3Q**：回答三问（风险 / 验证 / 应对），约 30 秒 | 对话里一段 `[3q]` 结论 |
| 复杂、协作或需可追溯 | **3r+plan**：按 [SOP.03] 做规划并收敛 | 反证与失败路径、Kill Criteria、证据等级 + 主方案与 Handoff（可选显式文档） |

- **入口**：简单任务从 `AIR.md`、`core/Skill-3Q.md` 开始；要完整规划从 `core/Skill-Planning.md`、`03-Workflow.md` [SOP.03] 开始。**何时升级**到 3r+plan（硬指标 + 直觉提示）见 `AIR.md`、`core/Skill-3Q.md`。
- **AI 执行 3r**：优先读 `core/AI-Execution-Guide.md`（入口、归档、自动分类与评审建议原则）。
- **强制入口协议（推荐复制粘贴）**：为避免 AI 不读法典导致执行坍塌，`Method=3r` 时建议使用 `core/Entry-Protocol.md` 的入口模板（含 `STOP: NEED FILES` / `[Readback]` / `[Compliance]` 门禁）。
- **作为技能安装**：3r-dna 可作为技能/规则安装到 Cursor、Claude、Windsurf、Codex 等主流工具，见 [install/README.md](install/README.md)。

---

## 单会话 vs 多 agent

- **单会话（默认）**：一个人或一个 AI 会话内完成规划与执行。用 3r+plan 时，收敛必须包含「反证/失败路径 ≥3」「Kill Criteria 1–2」「证据等级 A/B/C」，避免只列支持点、盲目推进。
- **多 agent / 协作**：先用 3r+plan 产出统一 Handoff 与验收标准，再按 [SOP.05 §7] 拆子任务、标依赖、共享同一归档；3r 负责规划质量，agent 负责执行效率。

---

## 原则

- **思维优先**：工具服务于思考质量，不替代思考；不凑数、不为了填表而填表。
- **先简单**：能用 3Q 就不上完整 SOP。
- **可追溯**：长任务分阶段或复杂任务：归档带版本与模型信息；归档含统一元数据（Method/TaskType 等），便于 3r 与 no3r 效果对比；效果评估以**质性复盘**为主，枚举/档位仅作索引（见 `03-Workflow.md` [SOP.05]）。
- **评阅外部建议时**：先核对事实再下结论，不盲目接受（详见 `core/AI-Execution-Guide.md` §8）。

---

## 目录与版本

```
3r-dna/
├── AIR.md                  # 默认入口（3Q）
├── core/
│   ├── AI-Execution-Guide.md   # AI 执行 3r 时优先读
│   ├── Entry-Protocol.md   # 入口协议模板（可复制到各工具）
│   ├── Skill-3Q.md         # 3Q 用法
│   └── Skill-Planning.md   # 3r+plan 用法
├── install/                # 作为技能安装到各主流工具（见 install/README.md）
├── 03-Workflow.md          # 工作流与 SOP.03 / SOP.05
├── 01-Security.md, 02-Stability.md, 04-AntiPatterns.md  # 法典
├── 00-INDEX.json           # 检索提示
├── history/                # 版本冻结归档（如 history/8.2.5/）
└── EVOLUTION_LOG.md        # 演进日志
```

- **当前版本**：v8.2.5（`META.json`）。历史版本冻结于 `history/<版本号>/`，见各目录下 `ARCHIVE.md`。
- 仓库 UTF-8；克隆后直接使用，推送前请以 UTF-8 保存避免乱码。

---

**上手**：打开 `AIR.md`，选一个当前任务做一次三问；需要完整规划时用 `3r+plan` 并参考 `core/Skill-Planning.md`。