Menu
提出新变更，创建并填充所有 artifact。适用于用户想快速描述需求并生成完整的 proposal、specs、design、tasks。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
预览 propose 生成的变更摘要。从 proposal/design/specs/tasks 浓缩为终端卡片，便于人快速 review，决定下一步是 apply 还是改 propose。
对照变更意图检查代码实现的完整性和一致性，支持基于 chrome-devtools MCP 的 UI 场景验证。
按变更的 tasks.md 逐个实现任务。适用于用户想按任务清单逐步实现代码。
归档已完成的变更。检查完成度后执行归档，适用于实现完毕后收尾。
进入探索模式 — 思考想法、调查问题、厘清需求。适用于用户想在动手之前先理清思路。
一键式轻量变更流程。创建 lite 变更、实现任务、询问归档，一气呵成。适合 bug 修复、小改动。
| name | marchen-propose |
| description | 提出新变更，创建并填充所有 artifact。适用于用户想快速描述需求并生成完整的 proposal、specs、design、tasks。 |
提出新变更 — 创建变更目录并按依赖顺序生成所有 artifact。
将创建以下 artifact：
完成后可用 /marchen:apply 开始实现。
输入：用户的请求应包含变更名称（kebab-case）或变更描述。
流程
确定变更名称
如果提供了输入，直接使用或从描述中提取 kebab-case 名称（如"添加用户认证" → add-user-auth）。
如果没有输入，用 AskUserQuestion 工具询问：
"你想做什么变更？描述一下你要构建或修复的内容。"
从回答中提取 kebab-case 名称。
重要：必须理解用户想做什么才能继续。
创建变更目录
marchen new <name>
创建 marchen/changes/<name>/ 目录和 .metadata.yaml。
如果同名变更已存在，用 AskUserQuestion 询问用户是继续已有变更还是换个名称。
循环创建 artifact
用 TaskCreate 工具创建任务列表追踪进度。
循环执行以下步骤：
a. 查询当前状态
marchen status <name> --json
返回 JSON 包含：
workflow.next：下一个应该创建的 artifact ID，全部完成时为 nullworkflow.ready：当前可以创建的 artifact 列表workflow.blocked：被阻塞的 artifact 列表artifacts：每个 artifact 的状态详情（id、status、path）如果 workflow.next 为 null → 全部完成，跳到第 4 步。
b. 获取创建指令
marchen instructions <name> <workflow.next> --json
返回 JSON 包含：
template：artifact 的 markdown 骨架结构，用它作为输出文件的框架instruction：如何填充该 artifact 的指导文本outputPath：写入路径（相对于变更目录）context：上下文 artifact 的信息数组，每项包含 id、status、content（已填充的内容直接在这里，不需要额外读文件）unlocks：完成此 artifact 后解锁的 artifact 列表c. 创建 artifact
根据 artifact 类型处理：
普通 artifact（proposal / design / tasks）：
context 中 status 为 filled 的 content 作为上下文instruction 指引 + template 结构生成内容marchen/changes/<name>/<outputPath>specs（目录型 artifact，outputPath 为 specs/）：
context 中，id 为 proposal 的 content）marchen/changes/<name>/specs/<capability>/template 结构 + instruction 指引生成 spec 内容specs/<capability>/spec.md如果 proposal 的上下文不够清晰（用户描述太模糊）：
d. 显示进度："已创建 <artifact-id>"，标记任务完成，回到步骤 a。
显示最终状态
marchen status <name>
输出
完成后显示：
变更名称和目录位置
已创建的 artifact 列表及简要说明
用纯文字（不调用 AskUserQuestion，不自动执行）提示下一步两个并列选项，由用户自行决定：
下一步：
/marchen:apply <name> 直接开始实现
/marchen:propose-preview <name> 先看一眼浓缩摘要再决定
护栏
instruction 是给你的指引，不要把它原样复制到 artifact 文件中