张翼 · Spread the Pinions

English: README_EN.md

你只有一个人。但你可以张开翅膀。

张翼是一套装进 AI 助手的游戏设计陪练 skill。你给它一句想法、一个做不做的纠结，或一版已有方案；它先给可修改的设计草案，再指出真正会影响玩家体验的取舍，陪你用小样和真人反馈检验。你拍板，它负责把判断、理由和未验证的风险留成档案。

**第一次使用？**在项目文件夹双击 启动张翼工作台.bat，保持弹出的命令窗口打开。需要已安装 Node.js。先看产品说明书：一页了解工作台、张翼 skill、项目包与后续接力。

它可以替你提出候选点子，也能在方向清楚后做一个可试玩的小版本：让你先玩，再决定值不值得继续做。它不会把候选当成你的决定，也不会仅凭纸面方案或自己生成的原型宣称游戏“好玩”。

两种用法，可以单用，也可以一起用

用法一 · 装进你的 AI 助手，直接聊。 把 skills/ 复制到 Agent 的 skills 目录（见安装），然后对你的 AI 说一句"我想做个游戏"。张翼 skill 负责判断：给草案、落裁决、留档案。

用法二 · 什么都不装，直接打开工作台。 双击 启动张翼工作台.bat，本地页面带你走 01 立项 → 02 审方案 → 03 做出来 → 04 试玩与修订；全程离线，选择都能导出成项目包带走。工作台负责让选择看得见、改得动、能带走。

两者互通：工作台导出的项目包可以交给装了张翼 skill 的 AI 接着做；AI 的审查结果也能导回工作台逐条拍板。

第一次使用，你会得到什么

你只要说：“我想做一个开猫咪咖啡馆的游戏。” 不用先懂“核心循环”“设计支柱”这些词。张翼应该先交一页能反应的草案：

这页草案不是替你定案。你说“我最想做装修”，张翼就应重新设计围绕装修的玩法，并说明保留它的成本。它的价值在做出有理由的判断，然后接受你的纠正，不是在回答里宣布“我使用了某个 skill”。

你可以在什么时候找张翼

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

为什么是"张翼"

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

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

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

三层形态

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

张翼之巢 · 裁决书档案馆（已上线）

双击打开 nest/index.html（零依赖、离线可用），把项目 verdicts/ 目录里的 裁决书拖进去——渲染成带朱砂印章的正式文书：过是红圆章、缓是蓝签收章、 否是红方章、装饰是虚线作废戳。支持打开整个 verdicts 目录逐份翻阅（Chromium）， Ctrl+P 可直接打印存档。

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

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

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

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

当前范围（v0.6.1 · 2026-10-01）

九个 skill 已实装。

安装

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

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

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

授翼仪式

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

许可与版权

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

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