星期五

# 星期五 (Friday) - 专用编程代理

**定位：** 专注于代码编写、审查和重构的编程代理  
**核心工具：** opencode CLI  
**模型：** 支持多种编程优化模型

## 何时使用

- 编写新功能代码
- 代码审查和 PR 审核
- 重构现有代码
- Bug 修复和调试
- 单元测试编写
- 技术文档生成

## 快速启动

### 一键执行任务

```bash
# 在当前项目目录运行
opencode run "你的编程任务描述"

# 指定工作目录
opencode run --workdir /path/to/project "任务描述"
```

### 后台运行（长时间任务）

```bash
# 启动后台会话
opencode run --background "构建完整的 REST API"

# 监控进度
opencode status <session-id>

# 查看日志
opencode log <session-id>
```

### 交互式会话

```bash
# 启动交互式编程会话
opencode chat

# 或直接进入项目
cd /path/to/project && opencode chat
```

## 核心功能

### 1. 代码生成

```bash
# 生成新功能
opencode run "创建一个用户认证模块，支持 JWT 和 OAuth2"

# 生成测试
opencode run "为 user_service.py 编写单元测试，覆盖率 90%+"
```

### 2. 代码审查

```bash
# 审查 PR
opencode run "审查这个 PR 的代码质量、安全性和性能问题"

# 代码审计
opencode run "审计这个模块的安全漏洞和代码异味"
```

### 3. 重构

```bash
# 重构代码
opencode run "重构这个函数，提高可读性和性能"

# 类型转换
opencode run "将这个 JavaScript 文件转换为 TypeScript"
```

### 4. 调试

```bash
# 分析错误
opencode run "分析这个错误日志，找出根本原因并修复"

# 性能优化
opencode run "分析这段代码的性能瓶颈并优化"
```

## 工作模式

### 全自动模式 (适合可信任务)

```bash
opencode run --auto "任务描述"
```

### 交互式模式 (需要确认)

```bash
opencode run --interactive "任务描述"
```

### 只读模式 (仅分析，不修改)

```bash
opencode run --read-only "分析这个架构并提出改进建议"
```

## 最佳实践

### 1. 明确任务范围

❌ 模糊："改进这个代码"  
✅ 明确："重构这个函数，减少嵌套层级，添加错误处理"

### 2. 提供上下文

```bash
# 指定相关文件
opencode run --context "src/,tests/" "添加输入验证"

# 指定技术栈
opencode run --stack "python,fastapi,postgresql" "创建用户 API"
```

### 3. 分步执行复杂任务

```bash
# 第一步：分析
opencode run --read-only "分析当前架...

# 星期五 (Friday) 🤖

**专用编程代理技能**

## 安装

```bash
clawdhub install friday
```

## 用途

星期五是一个专注于代码编写、审查和重构的编程代理。使用 opencode CLI 作为核心工具，支持多种编程优化模型。

## 快速开始

```bash
# 基本使用
opencode run "你的编程任务"

# 指定项目目录
cd /path/to/project && opencode run "添加用户认证功能"

# 交互式会话
opencode chat
```

## 典型场景

- ✍️ **代码生成** - 新功能、API、组件
- 🔍 **代码审查** - PR 审核、安全审计
- 🔄 **重构** - 代码优化、类型转换
- 🐛 **调试** - 错误分析、性能优化
- 🧪 **测试** - 单元测试、集成测试

## 配置

在 `~/.opencode/config.toml` 中配置默认模型和偏好设置。

## 文档

完整文档见 `SKILL.md`。

---

*让代码写得更快、更好、更安心。*