aph199686 / zhangyi-studio

# 张翼 · Spread the Pinions
> English: README_EN.md
> 你只有一个人。但你可以张开翅膀。
张翼是一套装进 AI 助手的**游戏设计陪练 skill**。你给它一句想法、一个做不做的纠结，或一版已有方案；它先给可修改的设计草案，再指出真正会影响玩家体验的取舍，陪你用小样和真人反馈检验。你拍板，它负责把判断、理由和未验证的风险留成档案。
**第一次使用？**在项目文件夹双击 `启动张翼工作台.bat`——它在后台启动本地服务并打开页面，命令窗口会自己关掉，不用保持打开；停止用 `停止张翼工作台.bat`或页面底部的「退出工作台」。需要已安装 Node.js。先看产品说明书：一页了解工作台、张翼 skill、项目包与后续接力。
它可以替你**提出候选点子**，也能在方向清楚后做一个可试玩的小版本：让你先玩，再决定值不值得继续做。它不会把候选当成你的决定，也不会仅凭纸面方案或自己生成的原型宣称游戏“好玩”。
## 两种用法，可以单用，也可以一起用
**用法一 · 装进你的 AI 助手，直接聊。** 把 `skills/` 复制到 Agent 的 skills 目录（见安装），然后对你的 AI 说一句"我想做个游戏"。张翼 skill 负责判断：给草案、落裁决、留档案。
**用法二 · 什么都不装，直接打开工作台。** 双击 `启动张翼工作台.bat`，本地页面带你走 01 立项 → 02 审方案 → 03 做出来 → 04 试玩与修订；全程离线，选择都能导出成项目包带走。本地服务在后台运行，命令窗口即开即关；要停止就双击 `停止张翼工作台.bat`。工作台负责让选择看得见、改得动、能带走。
两者互通：工作台导出的项目包可以交给装了张翼 skill 的 AI 接着做；AI 的审查结果也能导回工作台逐条拍板。
## 第一次使用，你会得到什么
你只要说：**“我想做一个开猫咪咖啡馆的游戏。”** 不用先懂“核心循环”“设计支柱”这些词。张翼应该先交一页能反应的草案：
| 你交给张翼 | 张翼替你推进 | 你能看见的变化 |
|---|---|---|
| “开猫咪咖啡馆”一句话 | 写出玩家头十分钟：接第一位客人、安排猫与座位、处理猫不愿接客的意外 | 从题材变成玩家真的能做的事 |
| 想同时做装修、繁育、外卖、社交 | 建议首版只保留“猫与客人的匹配”，其余先砍，并说明每项会挤掉什么 | 范围变小，游戏最特别的部分变清楚 |
| “这样会不会好玩？” | 指定最小可玩小样：三只性格不同的猫、三位需求冲突的客人；找陌生人玩，看他们是否愿意为自己的安排负责 | 把空泛的担心变成可以观察的问题 |
这页草案不是替你定案。你说“我最想做装修”，张翼就应重新设计围绕装修的玩法，并说明保留它的成本。它的价值在**做出有理由的判断，然后接受你的纠正**，不是在回答里宣布“我使用了某个 skill”。
## 你可以在什么时候找张翼
| 你眼下的难题 | 可以直接这样说 | 张翼应交给你什么 |
|---|---|---|
| 只有模糊点子 | “我想做一个……，帮我落地。” | 头十分钟怎么玩、亮点、先砍什么、下一步 |
| 喜欢一款现成游戏 | “我玩了《文明6》，想做五代十国版本。” | 分清模组、独立小样与完整游戏；先重现最喜欢的一段体验，不要求先有创新点 |
| 想尽快玩到灵感 | “我选这个方向，别讲术语了，做个能玩的最小版本。” | 可打开、能操作、有结果和重开入口的小样；说明它在试什么 |
| 想加一个功能 | “我想加联机/抽卡/第二套战斗，值不值？” | 它解决的问题、代价、过/缓/否的判断 |
| 故事和玩法分家 | “这段剧情和玩家操作怎么连起来？” | 角色想要什么、玩家的选择改变什么、输赢后故事怎么动 |
| 数值看着不对 | “这套经济/胜率会不会把玩家卡死？” | 先写清假设，再做模拟；指出模型能和不能证明什么 |
| 有可玩小样 | “找几个人试玩，应该看什么？” | 试玩任务、观察点、记录方式和基于样本的结论 |
| 要发售或隔天继续 | “现在能发吗？”/“帮我接着上次做。” | 有证据的检查结论 / 能接上进度的交接档案 |
不确定该走哪一步，直接把当前想法和最烦的一件事告诉它。张翼应先给草案，不把入门变成填表。
## 为什么是"张翼"
市面上的 AI 游戏工具都在解决"产能"。张翼解决的是"判断"。
- **它会裁决**：每次评审必落裁决（过 / 缓 / 否），没有"两个都有道理"。
- **它会诚实**：每次输出末尾带诚实声明——本次能证明什么、不能证明什么。
- **它会撤回**：新证据出现时，它公开撤回自己之前的结论，并记录为什么。
- **它会记账**：被否决的事项进否决清单，想复活？拿新证据来。
- **它会留档**：每次评审产出一份裁决书，存在你自己的项目仓库里，攒成你项目的档案。
用过张翼的项目，会攒下一册自己项目的裁决档案。
## 三层形态
 [code] 
### 张翼之巢 · 裁决档案墙与分享卡（已上线）
双击打开 `nest/index.html`（零依赖、离线可用），把项目 `verdicts/` 目录里的裁决书拖进去——一份，或者整个目录。多份会铺成**裁决档案墙**：每份一张卡片，印着编号、类型、日期与过／缓／否的结论分布，按编号排成网格；墙顶是评审时间刻度（相邻评审间隔超过 30 天标出停滞缺口，节点可点开），墙边是跨裁决书拉平的未决事项（待拍板与两周待办，点出处跳回对应裁决）。点开墙上任意一张看全文：逐条结论带朱砂印章（过是红圆章、缓是蓝签收章、否是红方章、装饰是虚线作废戳），页脚列出本篇引用的知识卡片——主张 24 字截断显示，附场景与出处，引用存在但查不到出处的如实标出。也支持打开整个 verdicts 目录逐份翻阅（Chromium），Ctrl+P 可直接打印存档。
每份裁决还能导出**裁决书分享卡**：一张 900×1200 的 PNG，印着编号、项目名、类型、日期、过／缓／否的结论分布，外加一句固定口径的诚实声明「全部结论未经真人验证——以各份裁决书的『诚实声明』为准」。卡面只到档案级，不带逐条裁决摘要，不把你方案里的设计内容带出去；全程本地生成（Canvas → PNG），不联网、不上传。
### 张翼工作台 · 立项、审方案与做出来
双击仓库根目录的 `启动张翼工作台.bat`，它会启动本地服务、选择可用端口并打开页面；关闭弹出的命令窗口会停止服务。进入页面可先选项目文件夹；点“保存项目包”会直接把 ZIP 写进该目录，同版本已有文件时自动使用新文件名，不覆盖旧包。当前内置浏览器没有直接写本地目录的接口，所以这一步由仅在本机监听的服务完成；也可粘贴目录路径或使用“浏览器下载”。直接打开 `nest/studio.html` 仍可离线答题，但不能直接存入指定文件夹。
从一款喜欢的游戏、一个玩法点、故事、模糊愿望或现有项目进入；入口可以多选。游戏品类独立于是否有现成工程。已有项目可导入 `zhangyi.project.json` 接着做，已确认的题不重问。记录起步路线和第一份作品重点