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:
root
2026-02-19 03:38:35 +08:00
parent f246f06cb1
commit be9542cf9d
7 changed files with 951 additions and 1 deletions

View File

@@ -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+