@fifine/aim-studio 0.0.2 → 0.0.4

package/dist/templates/claude/commands/aim/start.md

@@ -1,25 +1,25 @@
 ---
 name: start
-description: 开始 AIM Studio 创作会话
+description: 开始 AIM Studio 开发会话
 ---
 
 # 开始会话
 
-初始化 AIM Studio 漫剧创作会话，开始你的创作之旅。
+初始化 AIM Studio 开发会话，开始你的开发工作。
 
 ---
 
 ## 适用场景
 
-- 首次开始漫剧创作
-- 开始新的创作会话
+- 首次开始项目开发
+- 开始新的开发会话
 - 想要了解当前项目状态
 
 ---
 
 ## 使用步骤
 
-### 步骤 1：理解创作工作流
+### 步骤 1：理解工作流
 
 首先阅读工作流指南：
 
@@ -30,28 +30,74 @@ cat .aim-studio/workflow.md
 **遵循 workflow.md 中的指导**，包含：
 - 核心原则（先读后写、遵循规范等）
 - 文件系统结构
-- 创作流程
+- 开发流程
 - 最佳实践
 
 ### 步骤 2：获取当前上下文
 
 ```bash
-aim status
+python3 .aim-studio/scripts/get_context.py
+```
+
+或者查看项目状态：
+
+```bash
+python3 .aim-studio/scripts/task.py status
 ```
 
 显示：项目状态、当前任务（如有）、活跃任务列表。
 
-### 步骤 3：阅读创作规范
+### 步骤 3：阅读开发规范
+
+根据项目类型，阅读相应的规范：
 
+**如果是 CLI 项目**：
 ```bash
-cat .aim-studio/spec/story/script.md     # 剧本与分镜规范
-cat .aim-studio/spec/story/character.md  # 角色设定规范
-cat .aim-studio/spec/story/world.md      # 世界观设定规范
+cat .aim-studio/spec/cli/index.md           # CLI 开发规范
+cat .aim-studio/spec/cli/directory-structure.md
 ```
 
-### 步骤 4：开始创作
+**如果是前端项目**：
+```bash
+cat .aim-studio/spec/frontend/index.md     # 前端开发规范
+cat .aim-studio/spec/frontend/component-guidelines.md
+```
 
-报告你了解到的内容，询问用户："您想要创作什么内容？"
+**如果是后端项目**：
+```bash
+cat .aim-studio/spec/backend/index.md      # 后端开发规范
+cat .aim-studio/spec/backend/directory-structure.md
+```
+
+**如果是全栈项目**：
+```bash
+cat .aim-studio/spec/frontend/index.md
+cat .aim-studio/spec/backend/index.md
+```
+
+**如果是漫剧创作项目**：
+```bash
+cat .aim-studio/spec/story/script.md       # 剧本与分镜规范
+cat .aim-studio/spec/story/character.md    # 角色设定规范
+cat .aim-studio/spec/story/world.md        # 世界观设定规范
+```
+
+### 步骤 4：检查当前任务
+
+查看是否有待完成的任务：
+
+```bash
+python3 .aim-studio/scripts/task.py list
+```
+
+如果有任务，查看任务详情：
+```bash
+python3 .aim-studio/scripts/task.py show <任务名>
+```
+
+### 步骤 5：开始工作
+
+报告你了解到的内容，询问用户："您好！请问今天需要做什么？"
 
 ---
 
@@ -61,31 +107,46 @@ cat .aim-studio/spec/story/world.md      # 世界观设定规范
 
 | 类型 | 标准 | 处理方式 |
 |------|------|----------|
-| 问题 | 用户询问关于创作、角色、世界观的问题 | 直接回答 |
-| 简单修改 | 修改角色设定、世界观设定等 | 直接编辑 |
-| 创作任务 | 创作新剧集、场次、角色等 | 使用 `/aim:story` 创作工作流 |
+| 问题 | 用户询问关于项目的问题 | 直接回答 |
+| 简单修改 | 小改动 | 直接处理 |
+| 开发任务 | 需要多步骤完成的任务 | 创建任务并执行 |
+| 漫剧创作 | 创作新故事、角色等（仅限 story 项目） | 使用 `/aim:story` |
+
+---
+
+## 项目类型检测
+
+根据项目结构自动识别项目类型：
+
+| 项目类型 | 特征 | 规范目录 |
+|----------|------|----------|
+| CLI 工具 | 有 `bin/` 目录 | `spec/cli/` |
+| 前端 | 有 `package.json`、前端框架 | `spec/frontend/` |
+| 后端 | 有 `requirements.txt`、`go.mod` 等 | `spec/backend/` |
+| 全栈 | 既有前端又有后端 | `spec/frontend/` + `spec/backend/` |
+| 漫剧创作 | 有 `spec/story/` | `spec/story/` |
 
 ---
 
 ## 组合使用方案
 
-### 方案一：全新项目启动
+### 方案一：日常开发
 
 ```
 1. /aim:start              → 阅读工作流和项目状态
-2. /aim:story              → 开始创作新项目
-3. /aim:portrait <角色名>  → 生成角色肖像
-4. /aim:visualize          → 生成图片提示词
-5. /aim:finish-work        → 完成工作
+2. 讨论需求...
+3. /aim:finish-work        → 完成工作并记录
 ```
 
-### 方案二：继续现有创作
+### 方案二：漫剧创作（仅限 story 项目）
 
 ```
-1. /aim:start              → 查看当前进度
-2. /aim:check-story        → 检查剧情一致性
-3. 继续创作...
-4. /aim:finish-work        → 完成工作
+1. /aim:start              → 了解项目状态
+2. /aim:story              → 开始创作
+3. /aim:portrait <角色名>  → 创建角色肖像
+4. /aim:visualize          → 生成图片提示词
+5. /aim:check-story        → 检查剧情一致性
+6. /aim:finish-work         → 完成工作并记录
 ```
 
 ---
@@ -94,19 +155,25 @@ cat .aim-studio/spec/story/world.md      # 世界观设定规范
 
 > **规范是注入的，不是记忆的。**
 >
-> 创作工作流确保 AI 接收相关规范。这比希望 AI "记住"规范更可靠。
+> 开发工作流确保 AI 接收相关规范。这比希望 AI "记住"规范更可靠。
 
-> **Seedance 2.0 六要素必须完整。**
->
-> 每个场次文件必须包含：
-> 【主体描述】+【动作/表演】+【环境/氛围】+【镜头语言】+【音频设计】+【风格影调】
+---
+
+## 相关命令（根据项目类型使用）
+
+| 命令 | 用途 | 适用项目 |
+|------|------|----------|
+| `/aim:start` | 开始会话 | 所有 |
+| `/aim:story` | 漫剧创作模式 | story |
+| `/aim:portrait` | 生成角色肖像 | story |
+| `/aim:visualize` | 生成图片提示词 | story |
+| `/aim:check-story` | 检查剧情一致性 | story |
+| `/aim:finish-work` | 完成工作并生成日志 | 所有 |
 
 ---
 
-## 相关命令
+## 注意事项
 
-| 命令 | 用途 |
-|------|------|
-| `/aim:story` | 漫剧创作模式 |
-| `/aim:check-story` | 剧情逻辑检查 |
-| `/aim:finish-work` | 完成工作并生成日志 |
+1. **漫剧命令仅限 story 项目**：如果项目不是漫剧创作类型，`/aim:story` 等命令不可用
+2. **遵循项目规范**：开发前务必阅读 `spec/` 目录下的规范文件
+3. **记录工作进度**：完成工作后使用 `/aim:finish-work` 记录

package/dist/templates/claude/commands/aim/story.md

@@ -17,115 +17,321 @@ description: 启动漫剧创作模式
 
 ---
 
-## 使用步骤
+## 完整工作流程
 
-### 步骤 1：创建任务
+### 流程概览
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                        漫剧创作完整流程                                  │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  1. 初始化 ──────────────────────────────────────────────────────→     │
+│     aim init -u <你的名字>                                              │
+│                                                                         │
+│  2. 开始工作 ────────────────────────────────────────────────────→     │
+│     /aim:start                                                        │
+│                                                                         │
+│  3. 创作阶段 ────────────────────────────────────────────────────→     │
+│     │                                                                  │
+│     ├─→ /aim:story              启动漫剧创作                           │
+│     │                                                                  │
+│     ├─→ /aim:portrait <角色>   创建角色肖像（可选，可多次）            │
+│     │                                                                  │
+│     ├─→ /aim:visualize          生成场景图片（可选，可多次）           │
+│     │                                                                  │
+│     └─→ /aim:check-story       检查剧情一致性（可选，可多次）          │
+│                                                                         │
+│  4. 导出阶段 ────────────────────────────────────────────────────→     │
+│     │                                                                  │
+│     └─→ /aim:export            导出 Seedance 视频提示词              │
+│                                                                         │
+│  5. 完成工作 ────────────────────────────────────────────────────→     │
+│     /aim:finish-work                                                 │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 详细步骤
+
+### 步骤 1：初始化项目
 
 ```bash
-# 用法: /aim:story "故事标题"
-python3 .aim-studio/scripts/task.py create "<故事标题>" --priority P1
+# 在你的项目目录中
+aim init -u 你的名字
 ```
 
-### 步骤 2：开始创作
+这会创建以下结构：
 
-直接开始与用户讨论创作方向：
-- 询问用户想要创作什么类型的故事
-- 了解用户的创意需求
-- 根据用户的需求开始创作
+```
+项目目录/
+├── .aim-studio/              # 系统配置
+│   ├── spec/story/          # 创作规范
+│   │   ├── script.md        # 剧本规范
+│   │   ├── character.md     # 角色设定
+│   │   └── world.md         # 世界观设定
+│   └── tasks/               # 任务存储
+├── aim-workspace/           # 工作日志（你的创作记录）
+└── ...
+```
 
----
+### 步骤 2：开始工作
+
+```bash
+/aim:start
+```
+
+AI 会：
+1. 读取项目状态
+2. 查看最近的工作日志
+3. 询问你今天要做什么
+
+### 步骤 3：开始创作
+
+#### 3.1 启动创作模式
+
+```bash
+/aim:story
+```
+
+AI 会询问你想要创作什么。
+
+#### 3.2 创建角色（可选但推荐）
+
+当你创作了新角色后，使用：
+
+```bash
+/aim:portrait 角色名
+```
+
+**示例**：
+```
+/aim:portrait 慕容天
+/aim:portrait 沈安在
+/aim:portrait 女主角
+```
+
+这会生成角色的 AI 绘画提示词，你可以保存下来用于后续生成角色图片。
+
+#### 3.3 生成场景图片（可选）
+
+当你写完一个场景后，想要生成对应的图片：
+
+```bash
+/aim:visualize
+```
+
+这会将当前剧本段落转换为 Qwen-Image 优化的绘画提示词。
+
+#### 3.4 检查剧情一致性（推荐）
+
+完成一段创作后，检查是否有前后不一致：
+
+```bash
+/aim:check-story
+```
+
+这会检查：
+- 角色行为是否符合人设
+- 剧情逻辑是否连贯
+- 场景描述是否一致
+
+### 步骤 4：导出视频提示词
+
+当你完成一集或几集的创作后，准备生成视频：
+
+```bash
+/aim:export
+```
+
+实际上是在终端执行：
+
+```bash
+python3 .aim-studio/scripts/export.py --ep 1
+```
+
+#### 4.1 选择导出集数
+
+```bash
+# 导出第1集
+python3 .aim-studio/scripts/export.py --ep 1
+
+# 导出1-3集
+python3 .aim-studio/scripts/export.py --ep 1-3
+
+# 导出全部
+python3 .aim-studio/scripts/export.py --all
+```
+
+#### 4.2 选择视频时长
+
+根据场景复杂度选择：
+
+```bash
+# 5秒（简单对话）
+python3 .aim-studio/scripts/export.py --ep 1 --duration 5
+
+# 10秒（默认，通用）
+python3 .aim-studio/scripts/export.py --ep 1 --duration 10
+
+# 15秒（中等复杂度）
+python3 .aim-studio/scripts/export.py --ep 1 --duration 15
+
+# 30秒（复杂场景）
+python3 .aim-studio/scripts/export.py --ep 1 --duration 30
+
+# 45秒或60秒（长场景）
+python3 .aim-studio/scripts/export.py --ep 1 --duration 45
+python3 .aim-studio/scripts/export.py --ep 1 --duration 60
+```
+
+#### 4.3 违规检测
 
-## 创作流程
+导出时会自动检查违规内容：
 
-### 1. 理解用户需求
+| 违规类型 | 检测内容 | 风险等级 |
+|----------|----------|----------|
+| 真人素材 | 明星、网红、真实照片 | ⚠️ 高风险 |
+| 版权内容 | 金庸小说、漫威、哈利波特 | ⚠️ 中风险 |
+| 敏感内容 | 暴力、血腥、政治 | ⚠️ 中风险 |
 
-在开始之前，理解用户想要什么：
-- 创作什么类型的内容？（新剧集、修改现有内容等）
-- 有什么特定要求或约束？
-- 需要参考哪些原文？
+如果检测到违规，系统会提示你选择处理方式：
 
-如果不清楚，询问澄清问题。
+```
+请选择处理方式（输入数字）：
+  1. 修改角色设定 - 使用虚构角色替代真人
+  2. 替换版权内容 - 使用原创元素
+  3. 简化敏感描述 - 移除敏感描述
+  4. 强制导出 - 仍要导出（风险自负）
+  5. 退出 - 不导出
+```
 
-### 2. 阅读原文（如果需要改编小说）
+#### 4.4 完整导出示例
 
 ```bash
-cat .aim-studio/materials/原著.txt
+# 最常用：导出第1集，10秒，自动打开文件夹
+python3 .aim-studio/scripts/export.py --ep 1 --open
+
+# 完整参数：导出第1集，30秒，seedance格式
+python3 .aim-studio/scripts/export.py --ep 1 --duration 30 --format seedance
+
+# 批量导出：1-3集，15秒
+python3 .aim-studio/scripts/export.py --ep 1-3 --duration 15
 ```
 
-提取关键信息：
-- 角色特征
-- 场景描述
-- 剧情要点
+#### 4.5 仅检查违规
 
-### 3. 角色与世界观设定
+如果你只想检查内容是否合规，不导出：
 
-如果用户需要创建角色和世界观：
+```bash
+python3 .aim-studio/scripts/export.py --check
+```
 
-1. **创建角色设定** - 使用 `/aim:portrait <角色名>` 生成角色肖像提示词
-2. **设定世界观** - 编辑 `.aim-studio/spec/story/world.md`
+### 步骤 5：完成工作
 
-### 4. 开始创作
+```bash
+/aim:finish-work
+```
+
+这会：
+1. 检查内容完整性
+2. 检查格式是否符合规范
+3. 可选：运行剧情一致性检查
+4. 记录工作内容
 
-根据任务类型开始创作：
+#### 5.1 记录会话（可选单独使用）
 
-**新剧集创作**：
-1. 阅读全局上下文（角色设定、世界观）
-2. 阅读上一集的上下文摘要
-3. 按照场次拆分创作
-4. 每个场次遵循 Seedance 2.0 Prompt 六要素
+```bash
+# 记录本次工作
+python3 ./.aim-studio/scripts/add_session.py \
+  --title "第1集创作" \
+  --summary "完成第1集前5场的创作"
+```
 
 ---
 
-## 组合使用方案
+## 常见场景
 
-### 完整创作流程
+### 场景 1：全新项目，从零开始
 
 ```
-1. /aim:start              → 了解项目状态
-2. /aim:story              → 开始创作
-3. /aim:portrait 慕容天    → 创建第一个角色
-4. /aim:portrait 沈安在    → 创建第二个角色
-5. 编辑 world.md           → 设定世界观
-6. 创作第1集...           → 开始剧本创作
-7. /aim:visualize         → 生成图片提示词
-8. /aim:check-story       → 检查剧情一致性
-9. /aim:finish-work       → 完成并记录
+1. aim init -u 我的名字
+2. /aim:start
+3. /aim:story
+   → 告诉 AI 要创作什么类型的故事
+4. 创作角色和剧情...
+5. /aim:portrait 角色1
+6. /aim:portrait 角色2
+7. 继续创作...
+8. /aim:check-story
+9. /aim:export --ep 1 --open
+10. /aim:finish-work
 ```
 
-### 快速创作流程
+### 场景 2：继续之前的创作
 
 ```
-1. /aim:story              → 直接开始
-2. 创作...
-3. /aim:finish-work        → 完成
+1. /aim:start
+   → AI 会读取之前的进度
+2. 继续创作...
+3. /aim:check-story
+4. /aim:export --ep 2 --duration 15
+5. /aim:finish-work
+```
+
+### 场景 3：修改角色设定
+
+```
+1. /aim:portrait 角色名
+   → 生成新的肖像提示词
+2. 手动更新 character.md
+3. /aim:check-story
+   → 检查修改后是否一致
+```
+
+### 场景 4：生成宣传图片
+
+```
+1. /aim:visualize
+   → 将剧本场景转换为图片提示词
+2. 复制提示词到 AI 绘画工具
+3. 生成图片
 ```
 
 ---
 
-## Seedance 2.0 六要素
+## 参数速查表
+
+### export.py 完整参数
 
-每个场次文件必须包含：
+| 参数 | 必填 | 可选值 | 默认值 | 说明 |
+|------|------|--------|--------|------|
+| `--ep` | 是 | `1`, `1-3`, `all` | 无 | 导出集数 |
+| `--format` | 否 | `seedance`, `simple` | `seedance` | 格式 |
+| `--duration` | 否 | `5/10/15/30/45/60` | `10` | 时长(秒) |
+| `--output` | 否 | 目录名 | `export` | 输出目录 |
+| `--open` | 否 | 开关 | 关闭 | 导出后打开 |
+| `--check` | 否 | 开关 | 关闭 | 仅检查违规 |
+| `--force` | 否 | 开关 | 关闭 | 强制导出 |
 
-| 要素 | 说明 | 示例 |
+### add_session.py 参数
+
+| 参数 | 必填 | 说明 |
 |------|------|------|
-| 主体描述 | 角色外观、服装、体型 | 白衣少年，十七八岁，背负长剑 |
-| 动作/表演 | 具体动作，情绪强度 | 缓步走进大殿，眉头微皱 |
-| 环境/氛围 | 场景、时间、天气 | 青云峰主殿，清晨，阳光明媚 |
-| 镜头语言 | 运镜、景别、特效 | 近景切入，缓慢推进 |
-| 音频设计 | 人声、环境音、音乐 | 古琴声由远及近，配笛音 |
-| 风格影调 | 视觉风格、色调 | 水墨风，暖色调，参考《大鱼海棠》 |
+| `--title` | 是 | 会话标题 |
+| `--summary` | 是 | 工作摘要 |
+| `--commit` | 否 | Git 提交哈希 |
 
 ---
 
-## 核心原则
-
-> **规范是注入的，不是记忆的。**
->
-> 创作工作流确保 AI 接收相关规范。这比希望 AI "记住"规范更可靠。
+## 注意事项
 
-> **角色一致性最重要**
->
-> 每次创作前回顾 character.md，确保行为符合人设。
+1. **先检查后导出**：建议先运行 `--check` 确认无违规
+2. **选择合适时长**：复杂场景用 15-30 秒，简单对话用 5-10 秒
+3. **保持角色一致**：每次创作前回顾 character.md
+4. **记录工作进度**：完成后使用 finish-work 记录，便于后续继续
 
 ---
 
@@ -134,7 +340,9 @@ cat .aim-studio/materials/原著.txt
 | 命令 | 用途 |
 |------|------|
 | `/aim:start` | 开始会话 |
+| `/aim:story` | 开始创作 |
 | `/aim:portrait` | 生成角色肖像 |
-| `/aim:visualize` | 生成图片提示词 |
+| `/aim:visualize` | 生成场景图片 |
 | `/aim:check-story` | 检查剧情一致性 |
+| `/aim:export` | 导出视频提示词 |
 | `/aim:finish-work` | 完成工作 |

package/dist/templates/claude/hooks/inject-subagent-context.py

@@ -45,7 +45,7 @@ if sys.platform == "win32":
 # =============================================================================
 
 DIR_WORKFLOW = ".aim-studio"
-DIR_WORKSPACE = "workspace"
+DIR_WORKSPACE = "aim-workspace"
 DIR_TASKS = "tasks"
 DIR_SPEC = "spec"
 FILE_CURRENT_TASK = ".current-task"
@@ -337,10 +337,8 @@ def get_check_context(repo_root: str, task_dir: str) -> str:
     else:
         # Fallback: use hardcoded check files + spec.jsonl
         check_files = [
-            (".claude/commands/trellis/finish-work.md", "Finish work checklist"),
-            (".claude/commands/trellis/check-cross-layer.md", "Cross-layer check spec"),
-            (".claude/commands/trellis/check-backend.md", "Backend check spec"),
-            (".claude/commands/trellis/check-frontend.md", "Frontend check spec"),
+            (".claude/commands/aim/finish-work.md", "Finish work checklist"),
+            (".claude/commands/aim/check-story.md", "Story check spec"),
         ]
         for file_path, description in check_files:
             content = read_file_content(repo_root, file_path)
@@ -382,11 +380,11 @@ def get_finish_context(repo_root: str, task_dir: str) -> str:
     else:
         # Fallback: only finish-work.md (lightweight)
         finish_work = read_file_content(
-            repo_root, ".claude/commands/trellis/finish-work.md"
+            repo_root, ".claude/commands/aim/finish-work.md"
         )
         if finish_work:
             context_parts.append(
-                f"=== .claude/commands/trellis/finish-work.md (Finish checklist) ===\n{finish_work}"
+                f"=== .claude/commands/aim/finish-work.md (Finish checklist) ===\n{finish_work}"
             )
 
     # 2. Requirements document (for verifying requirements are met)
@@ -422,9 +420,7 @@ def get_debug_context(repo_root: str, task_dir: str) -> str:
             context_parts.append(f"=== {file_path} (Dev spec) ===\n{content}")
 
         check_files = [
-            (".claude/commands/trellis/check-backend.md", "Backend check spec"),
-            (".claude/commands/trellis/check-frontend.md", "Frontend check spec"),
-            (".claude/commands/trellis/check-cross-layer.md", "Cross-layer check spec"),
+            (".claude/commands/aim/check-story.md", "Story check spec"),
         ]
         for file_path, description in check_files:
             content = read_file_content(repo_root, file_path)