艺术家工作区搭建指南 - 快速创建智能体工作环境与目录结构

setup-artist by recoupable/setup-artist

1,100 周安装量

GitHub

安装命令

npx skills add https://github.com/recoupable/setup-artist --skill setup-artist

AI/机器学习开发生产力

🇨🇳中文介绍

艺术家工作区搭建

快速搭建完整的艺术家工作区，让智能体能够立即开始工作。

前提条件

沙箱环境已设置完成（参见 setup-sandbox 技能）
艺术家文件夹已存在于 orgs/{org}/artists/{artist-slug}/ 路径下，并且包含一个 RECOUP.md 标记文件
RECOUP.md 文件包含艺术家的姓名、slug 和 Recoup ID（由 setup-sandbox 创建）

文件夹结构

{artist-slug}/
├── RECOUP.md
├── README.md
├── .env.example
├── .env
├── context/
│   ├── artist.md
│   ├── audience.md
│   ├── era.json
│   ├── tasks.md
│   └── images/
│       └── README.md
├── memory/
│   ├── README.md
│   └── MEMORY.md
├── songs/
│   └── README.md
├── releases/
│   └── README.md
├── content/
│   ├── README.md
│   ├── images/
│   └── videos/
├── config/
│   ├── README.md
│   └── SERVICES.md
├── library/
│   └── README.md
└── apps/
    └── README.md

🇺🇸English

Setup Artist

Scaffold a complete artist workspace so agents can start working immediately.

Prerequisites

The sandbox has already been set up (see setup-sandbox skill)
An artist folder exists at orgs/{org}/artists/{artist-slug}/ with a RECOUP.md marker file
The RECOUP.md file contains the artist's name, slug, and Recoup ID (created by setup-sandbox)

Folder Structure

{artist-slug}/
├── RECOUP.md
├── README.md
├── .env.example
├── .env
├── context/
│   ├── artist.md
│   ├── audience.md
│   ├── era.json
│   ├── tasks.md
│   └── images/
│       └── README.md
├── memory/
│   ├── README.md
│   └── MEMORY.md
├── songs/
│   └── README.md
├── releases/
│   └── README.md
├── content/
│   ├── README.md
│   ├── images/
│   └── videos/
├── config/
│   ├── README.md
│   └── SERVICES.md
├── library/
│   └── README.md
└── apps/
    └── README.md

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

步骤 1：读取 `RECOUP.md` 并创建目录结构

导航到艺术家文件夹并读取 RECOUP.md 以获取艺术家的姓名、slug 和 ID：
```
cd orgs/{org}/artists/{artist-slug}
cat RECOUP.md
```

创建目录结构：

mkdir -p {context/images,memory,songs,releases,content/images,content/videos,config,library,apps}

步骤 2：更新 `RECOUP.md`

将 status 字段从 not-setup 更新为 active，并将正文替换为简要描述：

---
artistName: {Artist Name}
artistSlug: {artist-slug}
artistId: {uuid-from-recoupable}
status: active
---

# {Artist Name}

将此工作区连接到 Recoupable 平台。完整的目录指南和设置清单请参见 `README.md`。

步骤 3：创建上下文文件

根据 references/context-files.md 中的模板创建每个文件。核心文件包括：

文件	操作说明
`context/artist.md`	填写艺术家身份、品牌、视觉世界、声音、语调。向用户询问详细信息或研究该艺术家。
`context/audience.md`	填写受众洞察。关注他们为什么听、他们认同什么、他们如何谈论。
`context/era.json`	设置当前的发行、歌曲、阶段和职业生涯阶段。
`context/tasks.md`	留空 —— 用户将在任务出现时添加。
`context/images/README.md`	创建一个说明，解释此文件夹用于存放视觉参考（如面部指南）。

步骤 4：创建记忆系统

创建两个文件：

memory/README.md —— 为智能体提供关于如何使用记忆系统的完整说明，包括范围概念。参见 references/memory-system.md。
memory/MEMORY.md —— 几乎为空的起点，包含 frontmatter 和指导性注释（包括范围规则）。

记忆系统使用三个范围来防止知识膨胀：

permanent —— 无论处于哪个时代都成立（放入 MEMORY.md）
era —— 在当前发行周期内成立（放入 MEMORY.md，并标记时代）
session —— 关于特定内容或任务（仅放入 log/，绝不放入 MEMORY.md）

智能体在将反馈保存到长期记忆之前，应向用户询问范围。

步骤 5：创建服务和环境变量文件

服务在 config/ 中跟踪，不在设置时预先填充。创建：

文件	操作说明
`config/SERVICES.md`	为智能体提供关于在发现服务时如何添加服务的说明。参见 `references/services-guide.md`。
`.env.example`	常见环境变量名称的参考列表（全部注释掉）。参见 `references/env-template.md`。
`.env`	带有标题注释的空文件。智能体在连接服务时在此处添加凭据。

请勿预先填充服务条目。 服务应在智能体拥有真实信息（如账号、API 密钥、已确认的账户）时添加。旧方法（创建一个包含所有可能服务并设置为 not-setup 的巨大 JSON 文件）只会产生噪音，而非价值。

步骤 6：为其余目录创建 README 文件

每个目录都需要一个 README.md 来解释其用途。模板请参见 references/directory-readmes.md。

目录	README 解释...
`songs/`	歌曲文件夹格式、命名约定、应添加哪些文件
`releases/`	发行文件夹格式、`RELEASE.md` 作为事实来源
`content/`	生成的内容输出 —— 图像和视频
`config/`	每位艺术家的配置、服务和共享的自动化工具
`library/`	深度参考文档、研究报告
`apps/`	艺术家特定的应用程序（非共享工具）

步骤 7：创建根目录 README

在艺术家根目录创建 README.md，包含：

艺术家姓名作为标题
目录结构表格
上下文文件表格
配置与服务表格
设置清单

模板请参见 references/root-readme.md。

步骤 8：填写已知信息

如果您拥有关于该艺术家的信息（来自用户、研究或 Recoup 平台）：

尽可能多地填写 context/artist.md 中的身份/品牌信息
填写 context/audience.md 中的受众洞察
在 context/era.json 中设置当前的发行阶段

请勿捏造信息。 对于任何未知信息，请使用占位符。

git add -A
git commit -m "setup: create {artist-name} artist workspace"
git push origin main

目录和 slug： lowercase-kebab-case（例如 gatsby-grace，a-thing-called-love）
音频文件： 与文件夹 slug 匹配（例如 songs/a-thing-called-love/a-thing-called-love.mp3）
上下文文件： 严格按照指定名称使用 —— 智能体和共享工具依赖这些名称

从精简开始。 只创建必要的内容。智能体和流水线在运行时将创建额外的文件（如 content/videos/shortform/）。
使用占位符而非留空。 对于未知值，使用 {placeholder} 语法 —— 这比空白字段更好。
不要预先填充未知信息。 一个充满 not-setup 和 null 的文件不是占位符 —— 而是杂乱信息。服务、账户和配置应在它们成为现实时添加。
为所有内容编写 README。 每个目录都应有一个 README，以便智能体知道哪些内容属于那里。
避免重复。 歌曲存放在 songs/ 中，发行通过 slug 引用它们。内容存放在 content/ 中，不复制到其他地方。
限定记忆范围。 并非所有知识都是永恒的。标记特定时代的记忆，将会话反馈保留在日志中，并在提升到长期记忆前进行询问。

Step 1: Read `RECOUP.md` and create the directory structure

Navigate to the artist folder and read RECOUP.md to get the artist's name, slug, and ID:

cd orgs/{org}/artists/{artist-slug}

2. Create the directory structure:

mkdir -p {context/images,memory,songs,releases,content/images,content/videos,config,library,apps}

Step 2: Update `RECOUP.md`

Update the status field from not-setup to active and replace the body with a brief description:

---
artistName: {Artist Name}
artistSlug: {artist-slug}
artistId: {uuid-from-recoupable}
status: active
---

# {Artist Name}

Connects this workspace to the Recoupable platform. See `README.md` for the full directory guide and setup checklist.

Step 3: Create context files

Create each file from the templates in references/context-files.md. The essential files:

File	What to do
`context/artist.md`	Fill with artist identity, brand, visual world, voice, tone. Ask the user for details or research the artist.
`context/audience.md`	Fill with audience insights. Focus on WHY they listen, what they relate to, how they talk.
`context/era.json`	Set the current release, songs, phase, and career stage.
`context/tasks.md`	Leave blank — the user will add tasks as they come up.
`context/images/README.md`	Create with a note explaining this holds visual references like face guides.

Step 4: Create memory system

memory/README.md — Full instructions for agents on how to use the memory system, including the scope concept. See references/memory-system.md.
memory/MEMORY.md — Nearly empty starting point with frontmatter and guidelines comment (including scope rules).

The memory system uses three scopes to prevent knowledge bloat:

permanent — true regardless of era (goes in MEMORY.md)
era — true for the current release cycle (goes in MEMORY.md, tagged with era)
session — about a specific piece of content or task (goes in log/ only, never MEMORY.md)

Agents should ask the user about scope before saving feedback to long-term memory.

Step 5: Create services and environment files

Services are tracked in config/, not pre-filled at setup. Create:

File	What to do
`config/SERVICES.md`	Instructions for agents on how to add services as they're discovered. See `references/services-guide.md`.
`.env.example`	Reference list of common env var names (all commented out). See `references/env-template.md`.
`.env`	Empty file with a header comment. Agents add credentials here as services are connected.

Do NOT pre-fill service entries. Services are added when the agent has real information — a handle, an API key, a confirmed account. The old approach of creating a massive JSON file with every possible service set to not-setup creates noise, not value.

Step 6: Create README files for remaining directories

Each directory needs a README.md explaining its purpose. See references/directory-readmes.md for templates.

Directory	README explains...
`songs/`	Song folder format, naming conventions, what files to add
`releases/`	Release folder format, RELEASE.md as source of truth
`content/`	Generated content output — images and videos
`config/`	Per-artist config, services, and shared automation tools
`library/`	Deep-dive reference docs, research, reports
`apps/`	Artist-specific applications (not shared tools)

Step 7: Create root README

Create README.md at the artist root with:

Artist name as heading
Directory structure table
Context files table
Config & services table
Setup checklist

See references/root-readme.md for the template.

Step 8: Fill in what you can

If you have information about the artist (from the user, from research, or from the Recoup platform):

Fill context/artist.md with as much identity/brand info as possible
Fill context/audience.md with audience insights
Set context/era.json with the current release phase

Don't fabricate information. Leave placeholders for anything you don't know.

git add -A
git commit -m "setup: create {artist-name} artist workspace"
git push origin main

Directories and slugs: lowercase-kebab-case (e.g. gatsby-grace, a-thing-called-love)
Audio files: Match the folder slug (e.g. songs/a-thing-called-love/a-thing-called-love.mp3)
Context files: Use the names exactly as specified — agents and shared tools expect them

Start lean. Only create what's needed. Agents and pipelines will create additional files (like content/videos/shortform/) as they run.
Placeholders over empty. Use {placeholder} syntax for unknown values — it's better than blank fields.
Don't pre-fill what you don't know. A file full of not-setup and null isn't a placeholder — it's clutter. Services, accounts, and configs should be added when they're real.
README everything. Every directory gets a README so agents know what belongs there.
Don't duplicate. Songs live in songs/, releases reference them by slug. Content goes in content/, not copied elsewhere.
Scope your memories. Not all knowledge lasts forever. Tag era-specific memories, keep session feedback in logs, and ask before promoting to long-term memory.

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

103,800 周安装

艺术家工作区搭建指南 - 快速创建智能体工作环境与目录结构

🇨🇳中文介绍

艺术家工作区搭建

前提条件

文件夹结构

🇺🇸English

Setup Artist

Prerequisites

Folder Structure

相关 Skills

步骤

步骤 1：读取 `RECOUP.md` 并创建目录结构

步骤 2：更新 `RECOUP.md`

步骤 3：创建上下文文件

步骤 4：创建记忆系统

步骤 5：创建服务和环境变量文件

步骤 6：为其余目录创建 README 文件

步骤 7：创建根目录 README

步骤 8：填写已知信息

步骤 9：提交

命名约定

原则

Steps

Step 1: Read `RECOUP.md` and create the directory structure

Step 2: Update `RECOUP.md`

Step 3: Create context files

Step 4: Create memory system

Step 5: Create services and environment files

Step 6: Create README files for remaining directories

Step 7: Create root README

Step 8: Fill in what you can

Step 9: Commit

Naming Conventions

Principles

最新 Skills

艺术家工作区搭建指南 - 快速创建智能体工作环境与目录结构

🇨🇳中文介绍

艺术家工作区搭建

前提条件

文件夹结构

🇺🇸English

Setup Artist

Prerequisites

Folder Structure

相关 Skills

步骤

步骤 1：读取 RECOUP.md 并创建目录结构

步骤 2：更新 RECOUP.md

步骤 3：创建上下文文件

步骤 4：创建记忆系统

步骤 5：创建服务和环境变量文件

步骤 6：为其余目录创建 README 文件

步骤 7：创建根目录 README

步骤 8：填写已知信息

步骤 9：提交

命名约定

原则

Steps

Step 1: Read RECOUP.md and create the directory structure

Step 2: Update RECOUP.md

Step 3: Create context files

Step 4: Create memory system

Step 5: Create services and environment files

Step 6: Create README files for remaining directories

Step 7: Create root README

Step 8: Fill in what you can

Step 9: Commit

Naming Conventions

Principles

最新 Skills

步骤 1：读取 `RECOUP.md` 并创建目录结构

步骤 2：更新 `RECOUP.md`

Step 1: Read `RECOUP.md` and create the directory structure

Step 2: Update `RECOUP.md`