Skip to content

LeoYeAI/agent-master-skills / skills/anima-aios

anima-aios

Verified

An AI Agent cognitive growth system built on the native OpenClaw architecture. It provides agents with persistent memory management, visual intimacy progression, a 5-dimensional cognitive profile, gamified daily quests, team leaderboards, and a 5-layer memory architecture with Knowledge Palace, Pyramid thinking, and Ebbinghaus decay function. 基于 OpenClaw 原生架构的 AI Agent 认知成长体系,为 Agent 提供五层记忆架构、知识宫殿、金字塔知识组织、记忆衰减函数、LLM 智能处理、永久化记忆管理、可视化亲密度成长、五维认知画像、游戏化每日任务和团队排行榜。

FileKindSize
CHANGELOG.mdmarkdown2.4 KB
CONTRIBUTING.mdmarkdown3.3 KB
PLAN_v6.2.3.mdmarkdown5.3 KB
README.mdmarkdown5.1 KB
README_CN.mdmarkdown7.2 KB
RELEASE_v6.2.1.mdmarkdown3.5 KB
RELEASE_v6.2.2.mdmarkdown5.0 KB
RELEASE_v6.2.3.mdmarkdown4.0 KB
SECURITY.mdmarkdown2.6 KB
SECURITY_RESPONSE.mdmarkdown5.9 KB
SKILL.mdskill md23.5 KB
__init__.pyscript71 B
_meta.jsonconfig453 B
anima_doctor.pyscript26.4 KB
anima_tools.pyscript37.2 KB
config/__init__.pyscript0 B
config/agents/template.jsonconfig683 B
config/anima_config.template.jsonconfig1.5 KB
config/config_loader.pyscript9.3 KB
config/organization_config.jsonconfig1.2 KB
config/path_config.pyscript7.2 KB
core/__init__.pyscript1.5 KB
core/agent_resolver.pyscript5.1 KB
core/cognitive_profile.pyscript13.5 KB
core/daily_quest.pyscript13.9 KB
core/decay_function.pyscript6.8 KB
core/dimension_calculator.pyscript23.0 KB
core/distill_engine.pyscript18.8 KB
core/exp_tracker.pyscript15.0 KB
core/fact_store.pyscript9.5 KB
core/level_system.pyscript9.1 KB
core/memory_sync.pyscript6.1 KB
core/memory_watcher.pyscript14.9 KB
core/native_importer.pyscript31.0 KB
core/normalization_engine.pyscript11.7 KB
core/palace_classifier.pyscript12.2 KB
core/palace_index.pyscript10.7 KB
core/profile_card.pyscript9.6 KB
core/pyramid_engine.pyscript10.3 KB
core/session_scanner.pyscript12.7 KB
core/team_scanner.pyscript9.7 KB
docs/ARCHITECTURE_PRINCIPLES.mdmarkdown2.8 KB
docs/EXAMPLES.mdmarkdown2.1 KB
docs/USAGE.mdmarkdown2.8 KB
docs/session-jsonl-schema.mdmarkdown1.8 KB
health/__init__.pyscript16.9 KB
post-install.shscript2.2 KB
scripts/refresh-quests.shscript511 B
scripts/show-progress.shscript450 B
scripts/sync-memory.shscript1.4 KB
tests/__init__.pyscript627 B
tests/test_daily_quest.pyscript9.0 KB
tests/test_exp_tracker.pyscript8.6 KB
tests/test_integration_v6.pyscript8.9 KB
tests/test_normalization.pyscript8.2 KB

CONTRIBUTING.md

View on GitHub
# Contributing to Anima

感谢你有兴趣为 Anima 贡献代码!🌟

Anima 的目标是让 AI Agent 拥有成长的灵魂,每一个贡献都让这个项目更接近这个愿景。

## 🚀 快速开始

### 1. Fork 仓库

```bash
# 在 GitHub 上点击 Fork 按钮
# 然后克隆你的 fork
git clone https://github.com/YOUR_USERNAME/anima.git
cd anima
```

### 2. 创建分支

```bash
# 基于 main 分支创建新分支
git checkout -b feature/your-feature-name
```

分支命名规范:
- `feature/xxx` - 新功能
- `fix/xxx` - Bug 修复
- `docs/xxx` - 文档更新
- `refactor/xxx` - 代码重构
- `test/xxx` - 测试相关

### 3. 开发环境搭建

```bash
# 安装依赖
pip install watchdog

# 运行测试确保环境正常
cd anima-aios && python3 tests/test_integration_v6.py
```

### 4. 提交代码

```bash
# 添加修改
git add .

# 提交(使用清晰的提交信息)
git commit -m "feat: add new feature xxx"

# 推送到远程
git push origin feature/your-feature-name
```

### 5. 发起 Pull Request

在 GitHub 上发起 PR,使用 PR 模板填写相关信息。

## 🏗️ 代码结构

```
anima-aios/
├── core/           # 核心记忆架构(L1-L5)
│   ├── memory_watcher.py     # L1→L2 文件监听
│   ├── fact_store.py         # L2/L3 事实存储
│   ├── distill_engine.py     # L2→L3 LLM 提炼
│   ├── palace_index.py       # L4 记忆宫殿索引
│   ├── pyramid_engine.py     # L4 金字塔知识组织
│   ├── cognitive_profile.py  # L5 认知画像
│   ├── exp_tracker.py        # EXP 追踪
│   ├── native_importer.py    # v6.2 原生记忆导入
│   └── ...
├── health/         # 健康系统(5 个模块)
├── tests/          # 集成测试
├── docs/           # 文档
└── config/         # 配置文件
```

## 📝 开发规范

### 代码风格

- 遵循 PEP 8 规范
- 使用 4 个空格缩进
- 函数不超过 50 行
- 命名自解释(变量、函数、类)

### 提交信息规范

```
feat: add new feature xxx
fix: resolve memory leak in palace_classifier
docs: update README installation steps
refactor: simplify exp_tracker logic
test: add integration test for L4 pyramid
```

### 测试要求

- 新功能需要附带测试
- 提交前确保所有测试通过
- 运行测试:`python3 tests/test_integration_v6.py`

### 文档要求

- 新功能需要更新 README 或添加文档
- 代码注释清晰,特别是复杂逻辑
- 使用中文注释和文档

## 🎯 Good First Issues

新手推荐从标记了 [`good first issue`](https://github.com/anima-aios/anima/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) 的任务开始,这些任务相对简单,适合熟悉项目。

## 🧪 测试

```bash
# 运行集成测试(37 项检查)
cd anima-aios && python3 tests/test_integration_v6.py
```

## 📄 License

贡献的代码将遵循 [Apache 2.0 许可证](LICENSE)。

---

## ❓ 需要帮助?

- 查看 [README.md](README.md) 了解项目概况
- 查看 [docs/](docs/) 了解详细文档
- 发起 Issue 提问
- 在 OpenClaw 社区寻求支持

---

_Every contribution helps Anima grow — just like the Agents it serves._ ⭐️

**架构只能演进,不能退化。**
**先诚实,再迭代。代码要配得上宣传。**
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall