AgentSClub CoALA Course Helper

Assist with editing, maintaining, and extending AI agent course materials in the AgentSClub2PlantSClub repository. This skill focuses on the CoALA (Cognitive Architectures for Language Agents) curriculum, including presentations, teaching plans, and educational resources.

Project Context

This repository contains AI course curriculum materials in Chinese, focusing on cognitive architectures for language agents. The main content includes a 90-minute course design with an interactive HTML presentation synchronized with audio content.

Repository Structure

- `coala_presentation.html` - Interactive HTML presentation with audio player

- `coala.md` - 90-minute course curriculum and teaching plan

- `语言智能体的认知架构.wav` - Audio file for presentation

Instructions

When working with this repository:

1. **Language Handling**

- Maintain Chinese as the primary language for all educational content

- Preserve technical terms from the CoALA framework (arXiv:2309.02427v3)

- Keep bilingual content consistent where English headings appear

- Maintain academic tone appropriate for PhD students

2. **Presentation File (`coala_presentation.html`)**

- This is a self-contained HTML file with embedded CSS and JavaScript

- Features 10 slides with dark theme and minimalist design

- Custom audio player with speed controls (0.75x to 1.5x)

- Keyboard navigation: arrow keys, spacebar

- Audio file path: `"语言智能体的认知架构.wav"` (hardcoded relative path)

- Fallback duration "07:25" if audio metadata fails to load

- Animations use CSS transforms - preserve timing when editing

3. **When Modifying the Presentation**

- Verify audio file exists in same directory before testing

- Test keyboard navigation after structural changes

- Ensure slide counter and progress indicator update correctly

- Preserve responsive design breakpoints

- Maintain animation timing consistency (CSS transitions)

4. **Content Editing Guidelines**

- Keep research paper references intact (especially CoALA paper citation)

- Maintain consistency with framework terminology

- Ensure any new slides follow the existing 10-slide structure

- Sync audio timing if adding/removing slides

- Update slide counter max value if changing total slides

5. **Testing Considerations**

- Open HTML in browser to verify audio player functionality

- Test responsive design at different viewport widths

- Verify all navigation controls (keyboard, buttons)

- Check animation smoothness during slide transitions

- Confirm audio speed controls work correctly

6. **Version Control**

- Update `CHANGELOG.md` following semantic versioning conventions

- Document any changes to presentation structure or content

- Note audio synchronization adjustments

Common Tasks

**Adding a new slide:**

1. Duplicate an existing `<div class="slide">` block in the HTML

2. Update slide content with Chinese educational material

3. Increment the total slide count in JavaScript (`slides.length`)

4. Update progress indicator calculation if needed

5. Test navigation to ensure new slide is accessible

**Updating audio:**

1. Replace `语言智能体的认知架构.wav` file in `20250605/` directory

2. Update hardcoded duration in JavaScript if length changes

3. Test audio loading and playback controls

**Modifying course curriculum (`coala.md`):**

1. Maintain 90-minute session structure

2. Keep section headings consistent with presentation slides

3. Preserve teaching methodology and learning objectives

4. Update references if adding new research sources

**Troubleshooting audio issues:**

Example Usage

"Add a new slide about memory modules to the CoALA presentation"

"Update the course duration in coala.md from 90 to 120 minutes"

"Fix the audio player speed control buttons"

"Translate the slide headings to English while keeping body text in Chinese"

"Update CHANGELOG.md for version 1.1.0 with new slide additions"

Important Notes