76 lines
3.9 KiB
Markdown
76 lines
3.9 KiB
Markdown
# CLAUDE.md — Claude Code 项目指令与自动化运维规约
|
||
|
||
> 当 Claude Code 在本工作区（Seep）被唤醒时，自动加载此文件作为项目最高执行协议。
|
||
|
||
---
|
||
|
||
## 一、 项目背景与定位
|
||
|
||
本工程为面向 AI Agent 的**多平台客户端逆向工程与授权流安全审计（CWE-602）工作台**。深度覆盖 Windows PE/DLL、Android APK/DEX/SO、Linux ELF。包含 9 大逆向 Skill、4 大核心 MCP 服务、289 篇实战知识库与 9 个脱敏工业架构范式。
|
||
|
||
---
|
||
|
||
## 二、 Agent 自动化部署与校验协议 (Deployment & Verification Protocol)
|
||
|
||
### 1. 部署执行规约
|
||
当用户下达类似 **“帮我部署当前工作台”**、**“安装 Seep 环境”**、**“按文档部署”** 的指令时，Agent 必须直接在终端执行：
|
||
|
||
```powershell
|
||
cd setup
|
||
powershell -ExecutionPolicy Bypass -File .\install.ps1
|
||
```
|
||
|
||
### 2. 自动化校验与输出规范（★ 关键）
|
||
- **部署完成后，Agent 必须主动执行校验**，严禁在未做验证前直接向用户声称“部署完成”；
|
||
- **当用户在任何时候要求校验**（例如发送 `check`、`doctor`、`检查环境`、`帮我校验一下安装是否完整`）时，Agent 必须立即执行：
|
||
|
||
```powershell
|
||
powershell -NoProfile -ExecutionPolicy Bypass -File .\check.ps1
|
||
```
|
||
|
||
- **汇报输出要求**：
|
||
Agent 读取命令返回后，必须在对话框中向用户输出结构化 Markdown 体检卡片，包含以下 6 维度的明确反馈：
|
||
1. **📁 核心架构**：`Tool/` 根目录与 9 大案例库是否完备；
|
||
2. **🛠️ 技能系统**：`softseep`（总控）、`apkseep`、`ida-reverse` 等 9 个 Skill 是否已全部挂载；
|
||
3. **🔌 MCP 服务**：`seep` MCP（22项工具）、`ida`、`playwright`、`js-reverse` 的注册状态与路径是否有效；
|
||
4. **🧠 提示词与 Lab 状态机**：`SYSTEM.md` / `AGENTS.md` 及安全拦截扩展是否就绪；
|
||
5. **🔧 内置工具箱**：Jadx (v1.5.6)、Radare2 (v6.2.2)、Apktool (v3.0.3) 二进制是否可用；
|
||
6. **📚 战术知识库**：289 篇实战笔记与 3 个内置 MCP 源码组件是否可检索。
|
||
|
||
若全项通过，明确告知用户：**“工作台处于 [READY / 完备就绪] 状态，输入 lab： 即可开启测试。”**
|
||
|
||
---
|
||
|
||
## 三、 工作纪律与红线
|
||
|
||
1. **绝对禁止搬动 `Tool/mcp/Tool/` 目录**：seep MCP 内部硬编码了相对路径 `TOOL_DIR = <脚本目录>/Tool`，搬动将导致 22 个底层分析工具全部瘫痪。
|
||
2. **严禁修改 `seep_mcp_server.py` 的路径常量**。
|
||
3. **商业软件隔离**：IDA Pro 属于商业授权，不随包打包分发。检测不到时自动引导用户阅读 `MANUAL/IDA-PRO.md`，由 Radare2 自动降级承接。
|
||
4. **受权范围白盒审计（G-Auth）**：所有测试目标必须确认已获书面授权。
|
||
5. **凭据安全红线**：真实 Token/密钥/Salt/密码严禁外泄或记录于任何文档。
|
||
|
||
---
|
||
|
||
## 四、 目录树速览
|
||
|
||
```
|
||
Seep\
|
||
├── check.bat ← 双击一键体检入口
|
||
├── check.ps1 ← 命令行一键体检入口
|
||
├── CLAUDE.md ← 本文件（Claude Code 项目级指令）
|
||
├── .mcp.json ← 项目级 MCP 注册文件
|
||
├── DSH-PROFILE.md ← DeepSeek Harness 接入模板
|
||
│
|
||
├── Tool\
|
||
│ ├── skill\ 9 个 Skill（以 softseep 为总控）
|
||
│ ├── mcp\ seep MCP（22 工具）+ Tool\ 运行时依赖
|
||
│ │ └── Tool\safe\ 内置 Jadx、Radare2、Apktool、Hook 引擎等
|
||
│ ├── prompts\ SYSTEM.md、AGENTS.md 与安全扩展
|
||
│ ├── cases\ 9 个脱敏项目工程（项目 A ~ 项目 I）
|
||
│ ├── upstream\ apk-reverse 上游测试与验证集
|
||
│ ├── docs\ MCP-SETUP、DOWNLOADS、PROVENANCE 等
|
||
│ └── scripts\ 任务沙盒初始化与签名工作流
|
||
├── setup\ 安装与自检脚本集
|
||
└── MANUAL\ 环境依赖与商业授权自备指引
|
||
```
|