workspace-manager
GitHub管理Anima的工作区（项目目录），支持注册、列表、删除及权限分配。通过别名和哈希引用路径，更新组织共享配置，实现多工作区切换与子节点授权。
Trigger Scenarios
Install
npx skills add xuiltul/animaworks --skill workspace-manager -g -y
SKILL.md
Frontmatter
{
"name": "workspace-manager",
"tags": [
"workspace",
"directory",
"project",
"management"
],
"description": "ワークスペース（作業ディレクトリ）の登録・一覧・削除・割り当てを設定する。 Use when: プロジェクトパスをAnimaに紐付け、エイリアス管理、作業ディレクトリの切り替えが必要なとき。"
}
ワークスペース管理
Animaが作業するプロジェクトディレクトリ（ワークスペース）を管理するスキル。
概念
Animaは普段「自分の家」（~/.animaworks/animas/{name}/）にいる。 プロジェクトの作業をするときは「仕事場」（ワークスペース）に出かけて作業する。
ワークスペースは組織共有のレジストリ（config.json の workspaces セクション）に登録し、エイリアス#ハッシュで参照する。
エイリアスとハッシュ
- エイリアス: 人間が付ける短い名前（例:
myproject） - ハッシュ: パスのSHA-256先頭8桁が自動付与される（例:
3af4be6e） - 完全形:
myproject#3af4be6e— 衝突の可能性がゼロ - ツール引数にはエイリアスのみ、完全形、ハッシュのみ、絶対パスのいずれも使用可能
操作方法
登録
人間から明示指示を受けたトップレベルAnimaは grant_workspace_access を使う:
{
"alias": "finance-dashboard",
"path": "/absolute/path/to/project",
"make_default": true
}
このツールは root ホストに依頼し、組織共有レジストリと root 所有の permissions.json / status.json を更新する。Anima プロセスから設定ファイルを直接書き込まない。
注意: ディレクトリが存在しない場合はエラーになる。
注意: read_memory_file(path="config.json") は自分のAnimaディレクトリの config.json を読む。組織共有レジストリの登録には使わない。
一覧
組織共有レジストリの一覧は core.org.workspace.list_workspaces() で確認する。read_memory_file(path="config.json") は使わない。
削除
削除は管理者操作として扱う。通常の作業では既存エイリアスを上書きせず、新しいエイリアスを登録する。
自分のデフォルトワークスペース変更
トップレベルAnimaは grant_workspace_access に make_default: true を指定する。
非トップレベルAnimaは自分で権限追加できない。トップレベルAnimaに人間から指示してもらう。
部下への割り当て（スーパバイザー用）
人間から明示指示を受けたトップレベルAnimaは target_anima を指定して部下または子孫Animaに権限を付与できる:
{
"alias": "finance-dashboard",
"path": "/absolute/path/to/project",
"target_anima": "ritsu",
"make_default": true
}
ツールでの使用
- submit_tasks: 各タスクの
workspaceフィールドにエイリアスを指定 - delegate_task:
workspaceフィールドにエイリアスを指定
注意事項
- ディレクトリは登録時・使用時の両方で存在確認される
- 存在しないディレクトリを登録しようとするとエラー
- エイリアスを上書きするとハッシュも変わるため、旧ハッシュ参照は解決失敗する
- 人間はハッシュを覚える必要なし — エイリアスだけでOK
Version History
-
0f2a80e
Current 2026-10-19 11:13
重构了配置文件的归属权，明确root拥有config.json及每个anima的设置文件；引入内部API处理状态变更，禁止直接写入配置文件，增强安全性与控制。
-
edd4a93
2026-09-28 03:37
重构核心模块结构，将workspace相关功能从core根目录迁移至core/org/包下，并更新了对应的工具调用路径。
-
050238c
2026-08-20 03:20
移除了对已废弃machine工具的使用指引，清理了过时的文档说明。
- 140e43b 2026-07-25 09:14
