feat: 初始化 PERDAS 增强版开发环境
- 添加 feature_list.json: 6个功能,5个已完成 - 添加 PROGRESS.md: 进度跟踪文件 - 添加 init.sh: 一键启动开发环境 - 添加 scripts/health-check.sh: 健康检查脚本 - 添加 scripts/e2e-test.sh: 端到端测试脚本 - 添加 .gitignore: 忽略不需要的文件 - 更新 README.md: 添加 PERDAS 增强版使用说明 核心特点: - 强制增量开发(每次一个功能) - 强制端到端测试 - 强制截图证据 - 状态持久化 - 清晰的交接机制 遵循 Anthropic 长期运行代理研究最佳实践
This commit is contained in:
74
README.md
74
README.md
@@ -2,7 +2,79 @@
|
||||
|
||||
一个基于 Go + SQLite + 免费API的股票数据分析工具,内置网页界面。
|
||||
|
||||
## 🚀 快速开始
|
||||
## 🎯 开发模式 (PERDAS 增强版)
|
||||
|
||||
本项目采用 **PERDAS (Permanently Executing Development Agent System)** 增强版架构进行开发。
|
||||
|
||||
### 核心特点
|
||||
|
||||
✅ **增量开发** - 每次只实现一个功能
|
||||
✅ **强制测试** - 所有功能必须通过端到端测试
|
||||
✅ **可追溯** - 所有修改都有 Git 历史
|
||||
✅ **状态持久化** - 会话间保持工作连贯
|
||||
|
||||
### 工作流程
|
||||
|
||||
1. **初始化** - 运行 `init.sh` 启动环境
|
||||
2. **健康检查** - 运行 `scripts/health-check.sh` 验证环境
|
||||
3. **选择功能** - 查看 `feature_list.json` 了解任务
|
||||
4. **开发功能** - 按照步骤实现功能
|
||||
5. **端到端测试** - 运行 `scripts/e2e-test.sh` 验证
|
||||
6. **截图证据** - 保存测试截图到 `tests/screenshots/`
|
||||
7. **提交代码** - Git commit 并更新 `feature_list.json`
|
||||
|
||||
### 强约束指令
|
||||
|
||||
> **绝对禁止删除或修改测试用例**
|
||||
|
||||
- ❌ 不允许删除或修改测试用例
|
||||
- ❌ 不允许删除或修改其他功能的代码
|
||||
- ❌ 不允许修改 `feature_list.json` 中除 `passes` 字段外的内容
|
||||
- ❌ 不允许未通过端到端测试就标记完成
|
||||
- ❌ 不允许未保存截图证据就标记完成
|
||||
|
||||
### 开发工作流
|
||||
|
||||
每次会话开始时:
|
||||
|
||||
```bash
|
||||
# 1. 确认工作目录
|
||||
pwd # 应该是 /root/.openclaw/workspace/stock-tool
|
||||
|
||||
# 2. 启动开发环境
|
||||
./init.sh
|
||||
|
||||
# 3. 验证环境健康状态
|
||||
./scripts/health-check.sh
|
||||
|
||||
# 4. 运行端到端测试
|
||||
./scripts/e2e-test.sh
|
||||
|
||||
# 5. 查看功能清单
|
||||
cat feature_list.json
|
||||
|
||||
# 6. 查看进度
|
||||
cat PROGRESS.md
|
||||
```
|
||||
|
||||
每次开发完成时:
|
||||
|
||||
```bash
|
||||
# 1. 更新进度文件
|
||||
vim PROGRESS.md
|
||||
|
||||
# 2. 更新 feature_list.json(仅修改 passes 字段)
|
||||
jq '.features[] | select(.id=="feat-001") | .passes = true' feature_list.json > tmp.json && mv tmp.json feature_list.json
|
||||
|
||||
# 3. Git commit
|
||||
git add .
|
||||
git commit -m "feat: 完成 feat-001 股票列表展示功能"
|
||||
|
||||
# 4. 查看提交历史
|
||||
git log --oneline -5
|
||||
```
|
||||
|
||||
## 🚀 快速开始(标准模式)
|
||||
|
||||
### 环境要求
|
||||
- Go 1.21+
|
||||
|
||||
Reference in New Issue
Block a user