session-start

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Your Task

你的任务

Run the full session start procedure and report project status to the user.

执行完整的会话启动流程并向用户上报项目状态。

Session Start Skill

会话启动Skill

You perform the 8-step session startup procedure that initializes a working session.

你需要执行8步会话启动流程来初始化工作会话。

Step 1: Verify Setup

步骤1：验证设置

Quick dependency check:

bash

~/.bitwize-music/venv/bin/python3 -c "import mcp" 2>&1 >/dev/null && echo "MCP ready" || echo "MCP missing"

If MCP missing: Stop immediately and suggest:
```
/bitwize-music:setup mcp
```

If config missing (

~/.bitwize-music/config.yaml

doesn't exist): suggest

/bitwize-music:configure

Don't proceed until setup is complete

快速依赖检查：

bash

~/.bitwize-music/venv/bin/python3 -c "import mcp" 2>&1 >/dev/null && echo "MCP ready" || echo "MCP missing"

如果MCP缺失：立即终止流程并建议执行：
```
/bitwize-music:setup mcp
```

如果配置缺失（

~/.bitwize-music/config.yaml

不存在）：建议执行

/bitwize-music:configure

设置完成前不要继续执行后续步骤

Step 2: Load Config

步骤2：加载配置

Read

~/.bitwize-music/config.yaml

If missing, tell user to run

/bitwize-music:configure

读取

~/.bitwize-music/config.yaml

文件。

如果文件不存在，告知用户执行

/bitwize-music:configure

。

Step 3: Load Overrides

步骤3：加载自定义覆盖配置

Read

paths.overrides

from config (default:

{content_root}/overrides

Check for
```
{overrides}/CLAUDE.md
```
— incorporate instructions if found
Check for
```
{overrides}/pronunciation-guide.md
```
— note if found
Skip silently if missing (overrides are optional)

读取配置中的

paths.overrides

（默认路径：

{content_root}/overrides

）：

检查是否存在
```
{overrides}/CLAUDE.md
```
— 如果存在则合并其中的指令
检查是否存在
```
{overrides}/pronunciation-guide.md
```
— 如果存在则标记记录
如果文件缺失则静默跳过（覆盖配置为可选内容）

Step 4: Load State Cache

步骤4：加载状态缓存

Read

~/.bitwize-music/cache/state.json

If missing, corrupted, schema mismatch, or config changed: rebuild via MCP
```
rebuild_state()
```

读取

~/.bitwize-music/cache/state.json

：

如果文件缺失、损坏、schema不匹配或配置已变更：通过MCP重建
```
rebuild_state()
```

Step 4.5: Check for Plugin Upgrades

步骤4.5：检查插件升级

Compare

plugin_version

in state.json against current version in

${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json

If
plugin_version
is null (first run or pre-upgrade-system): Set to current version, skip migrations
If versions match: No action needed
If stored < current (upgrade detected):
- Read migration files from
```
${CLAUDE_PLUGIN_ROOT}/migrations/
```
  for versions between stored and current
- Process actions in order:
  - ```
  auto
```
  : Execute silently (run
```
  check
```
  first — skip if returns 0)
- ```
action
```
    : Show description, ask user to confirm before executing
  - ```
  info
```
  : Display to user
- ```
manual
```
    : Show instruction to user
- Rebuild state to update
```
plugin_version
```
Report: "Upgraded from X to Y" with summary of actions taken

对比

state.json

中的

plugin_version

与

${CLAUDE_PLUGIN_ROOT}/.claude-plugin/plugin.json

中的当前版本：

如果
plugin_version
为null（首次运行或升级前系统）：设置为当前版本，跳过迁移
如果版本匹配：无需执行任何操作
如果存储版本 < 当前版本（检测到升级）：
- 从
```
${CLAUDE_PLUGIN_ROOT}/migrations/
```
  读取存储版本到当前版本之间的所有迁移文件
- 按顺序处理操作：
  - ```
  auto
```
  ：静默执行（先运行
```
  check
```
  — 如果返回0则跳过）
- ```
action
```
    ：展示描述，请求用户确认后再执行
  - ```
  info
```
  ：向用户展示内容
- ```
manual
```
    ：向用户展示操作说明
- 重建状态更新
```
plugin_version
```
上报：「已从X版本升级到Y版本」以及已执行操作的摘要

Step 5: (Removed)

步骤5：（已移除）

Skill model checking is no longer part of session start. Run

/bitwize-music:skill-model-updater check

manually when new Claude models are released.

技能模型检查不再属于会话启动流程的一部分，当新的Claude模型发布时可手动执行

/bitwize-music:skill-model-updater check

。

Step 6: Report From State Cache

步骤6：基于状态缓存上报信息

Using data from

state.json

, report:

使用

state.json

中的数据，上报以下内容：

Album Ideas

专辑创意

From

state.ideas.counts

— show count by status (Pending, In Progress, etc.)

来自

state.ideas.counts

— 按状态展示数量（待处理、进行中等）

In-Progress Albums

进行中的专辑

Filter

state.albums

for status: "In Progress", "Research Complete", "Complete"

For each, show:

Album name, genre, status
Track progress (completed/total)

过滤

state.albums

中状态为「进行中」、「研究完成」、「已完成」的内容

每个专辑展示：

专辑名称、流派、状态
曲目进度（已完成/总数）

Pending Source Verifications

待处理的来源验证

From

state.albums

— find tracks where

sources_verified

is "Pending"

If any found, warn: "These tracks have unverified sources — generation is blocked until verified."

从

state.albums

中查找

sources_verified

状态为「待处理」的曲目

如果存在相关内容，警告：「这些曲目存在未验证的来源 — 验证完成前无法生成内容。」

Last Session Context

上一会话上下文

From

state.session

Last album worked on
Last phase
Pending actions

来自

state.session

：

上一个处理的专辑
上一个阶段
待处理操作

Step 7: Show Contextual Tips

步骤7：展示上下文提示

Based on state, show ONE relevant tip:

Condition	Tip
No albums exist	"Try `/bitwize-music:tutorial` to create your first album"
Ideas exist but no albums	"You have album ideas! Use `/bitwize-music:album-ideas list` to review them"
In-progress albums exist	"Resume where you left off: `/bitwize-music:resume <album-name>` "
Overrides loaded	"Custom overrides loaded from {overrides}/"
Overrides missing	"Customize your workflow with override files — see `/reference/overrides/` "
Pending verifications	"Source verification needed before generation can proceed"

Also show one random general tip (rotate through these):

"Ask 'what should I do next?' for workflow guidance"
"Use
```
/bitwize-music:resume
```
to quickly jump back into an album"
"The researcher skill coordinates 10 specialized sub-skills for deep research"
"Check pronunciation before generating — Suno can't infer from context"
"Use
```
/bitwize-music:clipboard
```
to copy lyrics/prompts for Suno"
"Master your audio with
```
/bitwize-music:mastering-engineer
```
for professional results"

基于当前状态，展示1条相关提示：

条件	提示
无已创建专辑	"尝试执行 `/bitwize-music:tutorial` 创建你的第一张专辑"
存在专辑创意但无已创建专辑	"你有未处理的专辑创意！执行 `/bitwize-music:album-ideas list` 查看详情"
存在进行中的专辑	"从上次中断的位置继续： `/bitwize-music:resume <album-name>` "
已加载覆盖配置	"已从{overrides}/加载自定义覆盖配置"
无覆盖配置	"可以使用覆盖配置文件自定义工作流 — 查看 `/reference/overrides/` 了解详情"
有待处理验证	"生成内容前需要完成来源验证"

同时展示1条随机通用提示（从以下列表轮询）：

"询问'接下来我该做什么？'获取工作流指引"
"使用
```
/bitwize-music:resume
```
快速回到专辑制作流程"
「研究Skill可以协调10个专业子Skill完成深度研究」
「生成内容前检查发音 — Suno无法从上下文推断发音」
"使用
```
/bitwize-music:clipboard
```
复制歌词/提示词到Suno"
"使用
```
/bitwize-music:mastering-engineer
```
处理音频获得专业效果"

Step 8: Ask

步骤8：询问用户

End with: "What would you like to work on?"

结尾输出：「你想要处理什么内容？」

Report Format

报告格式

SESSION START
=============

Setup: MCP ready, config loaded
Overrides: [loaded from {path} | not found (optional)]
State: [loaded | rebuilt | error]

ALBUM IDEAS
  Pending: X | In Progress: Y

IN-PROGRESS ALBUMS
  [album-name] (genre) - Status [X/Y tracks]
  [album-name] (genre) - Status [X/Y tracks]

PENDING VERIFICATIONS
  [album-name]: track-01, track-05

LAST SESSION
  Album: [name] | Phase: [phase]
  Pending: [actions]

TIP: [contextual tip]

What would you like to work on?

会话启动
=============

设置：MCP已就绪，配置已加载
覆盖配置：[已从{path}加载 | 未找到（可选）]
状态：[已加载 | 已重建 | 错误]

专辑创意
  待处理：X | 进行中：Y

进行中的专辑
  [album-name] (流派) - 状态 [X/Y 首曲目]
  [album-name] (流派) - 状态 [X/Y 首曲目]

待处理验证
  [album-name]：track-01, track-05

上一会话
  专辑：[name] | 阶段：[phase]
  待处理：[actions]

提示：[上下文提示内容]

你想要处理什么内容？

Remember

注意事项

Don't skip steps — Each step matters for session integrity
Rebuild state if needed — Stale state leads to wrong recommendations
Be concise — This is a status report, not a conversation
Warn about verifications — Unverified sources block generation
One tip, not five — Pick the most relevant tip for the current state

不要跳过步骤 — 每一步对会话完整性都至关重要
必要时重建状态 — 过期状态会导致错误的推荐
保持简洁 — 这是状态报告，不是对话
对验证问题发出警告 — 未验证的来源会阻塞生成流程
只展示1条提示 — 选择最贴合当前状态的提示