# SPEC-006: 智能体自进化 RSI 副轨调度与自增殖规范

- **规格编号**：`SPEC-006`
- **标题**：智能体驱动的自进化副轨调度、对抗博弈与规则自增殖工程规格说明书
- **状态**：已批准 (Approved) ✅
- **关联 ADR**：[`docs/adr/0003-智能体驱动的RSI副轨自进化三元组体系.md`](../adr/0003-智能体驱动的RSI副轨自进化三元组体系.md)
- **目标可复用工具产物**：
  - `scripts/agentic_crucible.py`（核心智能体自进化调度引擎）
  - `scripts/run_agentic_crucible.sh`（一键调用与部署包装脚本）
- **统一语言遵循**：[`CONTEXT.md`](../../CONTEXT.md)
- **编写时间**：2026年10月

---

## 1. 目标与价值 (Objectives)

构建一套**开箱即用、随时可在任意工程或 Worktree 中复用调用**的 Agentic RSI 自动化体系。
系统以智能体为主体，在隔离的 Git Worktree 中执行：
1. **红队探索 (Red-Team Probing)**：自主分析代码潜在风险，构造破坏性测试用例；
2. **蓝队自愈 (Blue-Team Healing)**：在隔离分支尝试代码修复，直到对抗测试通过；
3. **元进化自增殖 (Meta-Evolution)**：将本次捕获的缺陷提炼为**永久性静态 AST 规则或动态测试探针**，写入 `scripts/`，实现系统防御规则的自我进化。

---

## 2. 可复用脚本架构与接口规格 (Reusable Interface)

```mermaid
flowchart LR
    Caller["调用者<br>(人类 / Lead Agent / CI)"] --> EntryScript["scripts/run_agentic_crucible.sh<br>(一键调用入口)"]
    EntryScript --> CoreEngine["scripts/agentic_crucible.py<br>(智能体自进化调度引擎)"]

    subgraph TrinityPipeline ["三元组执行管道"]
        CoreEngine --> Stage1["1. 红队智能体<br>(生成变异攻击用例)"]
        Stage1 --> Stage2["2. 蓝队智能体<br>(生成原理级修复补丁)"]
        Stage2 --> Stage3["3. 元进化智能体<br>(规则代码自增殖落地)"]
    end

    Stage3 --> EvolvedAssets["沉淀至 scripts/ 与 docs/issues/<br>生成自进化 PR 交付报告"]
```

### 2.1 核心驱动器 (`scripts/agentic_crucible.py`) 命令行契约

```bash
python3 scripts/agentic_crucible.py [选项]
```

- `--worktree <path>`：指定要驻场巡检与演化的目标工作区路径（默认当前目录）；
- `--cycle <explore|heal|evolve|all>`：指定当前执行的演化阶段；
- `--inspect-target <file>`：指定要深入探矿和对抗的代码文件；
- `--json`：输出标准格式的智能体攻防与规则增殖报告；
- `--apply-evolution`：允许元进化智能体将新生成的防御规则直接写入当前代码库的检测工具链。

### 2.2 一键复用脚本 (`scripts/run_agentic_crucible.sh`) 契约

```bash
./scripts/run_agentic_crucible.sh [Worktree路径]
```
- 自动检测工作区、检查 Python/Node 运行环境；
- 启动三元组智能体自进化流程；
- 汇报红队攻击战果、蓝队修复结论与元进化增殖规则摘要。

---

## 3. 验收标准 (Acceptance Criteria)

1. **[AC-1 零依赖可移植性]**：`scripts/agentic_crucible.py` 与 `scripts/run_agentic_crucible.sh` 均为纯原生（基于 Python 3 标准库与 Shell），拷贝至任意其他项目均可立即可用；
2. **[AC-2 红队攻击用例生成]**：能够根据目标文件的代码特征，生成可真实运行的失败断言脚本；
3. **[AC-3 蓝队修复验证闭环]**：修复补丁必须在 Worktree 中通过沙盒回归测试；
4. **[AC-4 规则自增殖留痕]**：元进化智能体能够将新捕获的 Bug 模式自动沉淀为一条新规则文件（如 `scripts/rules/RULE-*.json` 或测试插件），实现副轨工具链的物理自我扩充。
