zhangyi

张翼 · 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”。

你可以在什么时候找张翼

不确定该走哪一步，直接把当前想法和最烦的一件事告诉它。张翼应先给草案，不把入门变成填表。

为什么是"张翼"

市面上的 AI 游戏工具都在解决"产能"。张翼解决的是"判断"。

• 它会裁决：每次评审必落裁决（过 / 缓 / 否），没有"两个都有道理"。
• 它会诚实：每次输出末尾带诚实声明——本次能证明什么、不能证明什么。
• 它会撤回：新证据出现时，它公开撤回自己之前的结论，并记录为什么。
• 它会记账：被否决的事项进否决清单，想复活？拿新证据来。
• 它会留档：每次评审产出一份裁决书，存在你自己的项目仓库里，攒成你项目的档案。

用过张翼的项目，会攒下一册自己项目的裁决档案。

三层形态

第一层 · 本体    标准 Agent Skills（本仓库），住进你已有的 AI 助手
第二层 · 巢      张翼之巢：本地 HTML，裁决档案墙与分享卡已上线
第三层 · 印记    裁决书：每次评审在你项目里留下一份带编号的档案，攒成你自己项目的决策史

张翼之巢 · 裁决档案墙与分享卡（已上线）

双击打开 nest/index.html（零依赖、离线可用），把项目 verdicts/ 目录里的裁决书拖进去——一份，或者整个目录。多份会铺成裁决档案墙：每份一张卡片，印着编号、类型、日期与过／缓／否的结论分布，按编号排成网格；墙顶是评审时间刻度（相邻评审间隔超过 30 天标出停滞缺口，节点可点开），墙边是跨裁决书拉平的未决事项（待拍板与两周待办，点出处跳回对应裁决）。点开墙上任意一张看全文：逐条结论带朱砂印章（过是红圆章、缓是蓝签收章、否是红方章、装饰是虚线作废戳），页脚列出本篇引用的知识卡片——主张 24 字截断显示，附场景与出处，引用存在但查不到出处的如实标出。也支持打开整个 verdicts 目录逐份翻阅（Chromium），Ctrl+P 可直接打印存档。

每份裁决还能导出裁决书分享卡：一张 900×1200 的 PNG，印着编号、项目名、类型、日期、过／缓／否的结论分布，外加一句固定口径的诚实声明「全部结论未经真人验证——以各份裁决书的『诚实声明』为准」。卡面只到档案级，不带逐条裁决摘要，不把你方案里的设计内容带出去；全程本地生成（Canvas → PNG），不联网、不上传。

张翼工作台 · 立项、审方案与做出来

双击仓库根目录的 启动张翼工作台.bat，它会启动本地服务、选择可用端口并打开页面；关闭弹出的命令窗口会停止服务。进入页面可先选项目文件夹；点“保存项目包”会直接把 ZIP 写进该目录，同版本已有文件时自动使用新文件名，不覆盖旧包。当前内置浏览器没有直接写本地目录的接口，所以这一步由仅在本机监听的服务完成；也可粘贴目录路径或使用“浏览器下载”。直接打开 nest/studio.html 仍可离线答题，但不能直接存入指定文件夹。

从一款喜欢的游戏、一个玩法点、故事、模糊愿望或现有项目进入；入口可以多选。游戏品类独立于是否有现成工程。已有项目可导入 zhangyi.project.json 接着做，已确认的题不重问。记录起步路线和第一份作品重点后，页面会显示适用的选择题；可集中作答、回改、展开可选题，并查看《立项书草案》。第二页“审方案”会显示已定骨架、已知矛盾、制作风险与需要玩家拍板的选择；也能把项目包交给带张翼 skill 的 AI 审查，再把结构化结果导回页面，逐条采纳或暂缓。第三页“做出来”把已审方案整理成《制作任务包》交给自己的 AI 或开发者，做出后把构建、运行、玩通、真人试玩四级可玩证据导回页面，证据状态板只随证据升级；方案改动后旧证据标为需复核。工作台在浏览器本地保存当前记录，第四页“试玩与修订”按证据状态导出《试飞任务》（首次观察/体验走查/修订核对三档），执行后导入场次级试玩记录（缺样本三要素降级为自述级），再生成《修订建议》回前两页拍板。导出的 ZIP 包含项目记录、项目总览、开发交接、立项书草案、方案审查记录、张翼审查任务、张翼介入记录、制作任务包和试飞任务，共九份同源文件。

当前 44 题题库与推荐均为明确标注的离线规则；部分推荐会根据已有决定变化，发现明确矛盾时会提示复核，但尚不能代替张翼的完整专业评审。立项书草案仍是已确认/暂拟/未定的结构化汇总。页面尚未直接调用张翼 skill 生成完整立项书或可玩小样。把导出的交接文档给 AI 助手继续推进即可。修改页面或产品说明书后运行 node tools/build_studio.mjs，同步生成离线脚本包与 nest/guide.html。

当前范围（V1.1 · 2026-10-15）

公开仓用宣发版号：每次对外宣发进 0.1（首次宣发 V1.1，下次 V1.1.1）。

九个 skill 已实装。

安装

一键安装（Windows / PowerShell）

先下载、看一眼、再执行——不写成 irm ... | iex，因为那样你看不到自己要跑什么。

第 1 步，下载脚本：

irm "https://cnb.cool/AphroZhang/zhangyi-studio/-/blob/main/tools/install.ps1?raw=true" -OutFile "$env:TEMP\zhangyi-install.ps1"

第 2 步，读一遍（可选，但建议）：

notepad "$env:TEMP\zhangyi-install.ps1"

第 3 步，执行。默认把本体装到 %USERPROFILE%\zhangyi-studio；想同时把九个 skill 装进你的 AI 助手，加上 -SkillsDir：

powershell -ExecutionPolicy Bypass -File "$env:TEMP\zhangyi-install.ps1" -SkillsDir "$HOME\.claude\skills"

-ExecutionPolicy Bypass 不能省：Windows 默认执行策略是 Restricted，不加会直接报“禁止运行脚本”。

常用参数：

安装器只做三件事：取回仓库、写入你指定的目录、把九个 skill 复制到你指定的 skills 目录；加 -Shortcut 时额外建桌面快捷方式。它不安装系统软件（Node.js 只检测并提示）、不删除任何文件、不覆盖已有内容——目标非空时会停下列出内容，要覆盖必须显式加 -Overwrite。

关于下载源： CNB 走 git 克隆，需要本机有 git；没有 git 的机器会自动回退到 GitHub 的 zip 包（约 50 MB，国内可能较慢）。CNB 目前不提供归档直下（实测三种路径都只返回网页），所以“既没有 git、又要下得快”这个组合暂时无解，请先装一个 Git。

手动安装

把 skills/ 下你需要的 skill 目录（共 9 个）复制到你的 agent 的 skills 目录：

• Kimi Code：C:\Users\<你>\.agents\skills\
• Claude Code：~/.claude/skills/
• WorkBuddy：~/.workbuddy/skills/

然后在你的游戏项目里对 AI 说一句“我想做个游戏”或直接讲你的点子。先看它给出的草案，再纠正不符合你想法的地方。

授翼仪式

第一次在你的项目里启用张翼时，它先给能玩起来的概念草案；你纠正后，它才把已确定的项目方向写入配置与第一份裁决书。只问“张翼能做什么”时，不创建项目文件。

许可与版权

• 本仓库代码与文档：MIT（见 LICENSE；公开仓 zhangyi-studio 同）
• cards/ 观点卡片库：只含提炼后的论点、适用场景、批注与出处链接，不含任何原文。原文版权归原作者所有，张翼只引用观点并注明出处。

---

张翼 Spread the Pinions —— 让一个人，也能张开翅膀。