Releases: cipher-wb/fengshen-skillAI
v1.0.14 — 源工程优化推送 + repo 加 CLAUDE.md
改动
源工程内容 (extract 自动抽过来)
- 新增 mental_model/SkillCondition系统.md 子系统页
- 加固 mental_model/SkillTag系统.md
- 新增 postmortem #042 (skillcondition-blueprint-misperception)
- 新增 postmortem #043 (designer-prompt-iron-rule-burial)
- CLAUDE.local.md 更新
fengshen-skillAI repo 自身
- 新增 CLAUDE.md 给新 AI 维护者的工作守则 (不进 npm 包 仅 repo 根)
- 用户最可能让你做的事 + 一行命令 (quick-release.ps1)
- 关键文件指针 + 反模式 + 环境配置
- 历史 bug 沉淀
quick-release.ps1 v2.1
- Step 4 npm version 加 LASTEXITCODE 检查 + 新旧版本对比
- 防 v1.0.14 那种 commit 已建但 version 没 bump → tag 冲突的隐性 bug
验证
cd D:\Unity\YourProject
npx fengshen-skillai@latest init . --force
npx fengshen-skillai doctor
v1.0.13 — hotfix: quick-release 正则 bug
hotfix v1.0.12 bug:
- scripts/quick-release.ps1 正则 mental_model_version[:：]\s*(v[\d.]+) 错匹配 prior_mental_model_version_ 字段
- 导致 package.json#fengshenMentalModelVersion 被错改成 v0.16.40
修法:
- 正则改 (?m)^mental_model_version[:：]\s*(v[\d.]+) (行首锚)
- package.json fengshenMentalModelVersion 修回 v0.16.41
验证: v1.0.13 重跑 quick-release v2 正确读到 v0.16.41 / mental_model 未变跳过 tarball
v1.0.12 — README 加 --dangerously-skip-permissions 提示
30 秒安装段下方新增 Tip: claude --dangerously-skip-permissions (一次性授权所有工具 / 不再每次点 yes)。含风险说明: 仅在 Unity 工程根用 / 别在 C:\ 或 ~ 根目录开。
注: v1.0.12 引入 quick-release.ps1 v2 正则 bug / 已 v1.0.13 hotfix
v1.0.11 — quick-release.ps1 v2 / mental_model 学习痕迹自动检测+上传
用户反馈: 学完新批次后完整学习痕迹会自动上传 GitHub 吗?
旧版 quick-release.ps1 漏一步: 没自动跑 prepare-release-tarball.js / 不挂 tar.gz
改动
scripts/quick-release.ps1 → v2
- 抽源后自动读 templates 的 mental_model_version
- 与 package.json 对比
- 变了 → 自动生成 tar.gz + sha256 → 写回 package.json → 挂 gh release
- 没变 → 跳过 tarball (不浪费时间)
- 新增 -ForceTarball / -SkipTarball 选项
- npm publish 自动 retry 3 次 (防 ECONNRESET)
- git push 自动绕开代理
FAQ 新增 Q&A
- '我学完新批次 / 学习痕迹会自动上传 GitHub 吗' 答案 + 流程
- 解释 v1.0.0-v1.0.10 现状 (mental_model 一直 v0.16.41 没变 / 只挂一份 tar.gz 是对的)
下次实战
cd F:\fengshen-skillAI
pwsh scripts/quick-release.ps1
自动: 检测 mental_model v0.16.41 → v0.16.42 变了
→ 生成 fengshen-learning-history-v0.16.42.tar.gz
→ 挂 GitHub Release v1.0.12
→ 别人 npx fengshen-skillai download-history 拿到新学习痕迹
v1.0.10 — README 精简 / 30 秒安装放最顶
用户反馈: README 废话太多 / 30 秒安装不够显眼
改动
README 从 498 行 -> 279 行 (砍 44%)
最顶部 = 30 秒安装 (3 步: cd + npx + claude)
紧跟 5 项前置依赖速查表
下面保留:
- 这能干什么 (1 个配 + 1 个审)
- 命令速查 + 升级 + 4 Agent + 7 道防线 (各 1 张简表)
详细段全部折叠到
- 前置依赖详情
- PowerShell 7 推荐
- CC Switch 模型选择
- 在哪跑 claude
- 配置文件 + 双模式 + 学习痕迹
打开 README 30 秒看到怎么用 / 想看细节再展开
docs/ 检查
- FAQ 已是 v1.0.7 工业化版本 / 无落后
- ARCHITECTURE / PUBLISHING / RELEASE 不涉及 review 描述 / 不用改
升级
cd D:\Unity\YourProject
npx fengshen-skillai@latest init . --force
v1.0.9 — README 加 PowerShell 7 推荐 + cmd 对比表
用户反馈: 大家觉得 cmd 不好用 / 建议加 PowerShell 7 推荐
新增
README '## 🖥️ 终端推荐：PowerShell 7'
-
winget 一行命令安装:
winget install --id Microsoft.PowerShell --source winget -
三方对比表 (cmd / PowerShell 5 / PowerShell 7) / 10 个维度:
- 中文 Unicode (cmd 乱码 / PS7 完美 UTF-8)
- && 命令链 (PS5 不支持是坑！PS7 OK)
- 跨平台 / 性能 / 错误信息 / Ctrl+R 智能搜 等
-
进阶推荐 Windows Terminal + PowerShell 7 组合 (winget 一行装)
-
注明: fengshen-skillai 命令在 cmd / PS5 / PS7 / Git Bash 都一样跑得通 / 换 PS7 只是更舒服
升级
cd D:\Unity\YourProject
npx fengshen-skillai@latest init . --force
v1.0.8 — README review 描述升级 v3.1 + 新增 CC Switch 模型选择推荐
两个用户反馈:
- README review 描述还停留旧版 (4 复制粘贴 / 只列关键节点) / 跟不上 v1.0.7 工业化
- 缺 CC Switch 模型选择推荐 / 防小白图便宜选 minimax 等弱模型
改动
README
- 重写 '审技能更工业化' 段 (3 大步 / 145 节点场景示意)
- 4 个 Agent 表 skill-reviewer 描述升级 (全节点 / P0 一起修)
- 命令速查 doctor 10→12 项
- 加 v1.0.7 review 工作流升级 v3.1 三点说明
README 新增 '## CC Switch 模型选择推荐'
- 6 档强度表
- 🥇 Opus 4.7 / Sonnet 4.6 (顶级)
- 🥈 GLM-4.6 / DeepSeek V3.2 (中上)
- 🥉 Qwen3-Max (中等)
- ❌ minimax / Yi (不推荐)
- ❌ 1 元/百万 token 模型 (绝对避免 / review 100+ 节点必崩)
- 3 个场景配置 (个人 / 国内团队 / 穷预算) + 具体 Provider Base URL
- 怎么验证模型能不能遵守工作流
FAQ
- 新增 '模型差异诊断' 段 / 4 层差异源 + 验证测试
升级
cd D:\Unity\YourProject
npx fengshen-skillai@latest init . --force
v1.0.7 — review 全节点 Desc 重写铁律 + designer 高效写入策略
用户反馈: review 写节点描述时要把整个蓝图所有节点都重写 / 不允许只列关键节点
改动
skill-reviewer.md
- 删除 '只列关键节点 / 辅助节点可省' 限制
- 全部节点 Desc 重写表 (v3.1 / 不省)
- 3 级分级 (P0 关键 / P1 重要 / P2 辅助) 指导 Desc 详尽度
- P2 速成模板 8 种 (NUM_CALC / ORDER / VALUE_COMPARE / GET_SKILL_TAG_VALUE / 等)
- 输出前自检 5 项 (节点数 = 蓝图实际数 / 不漏)
- §8 PENDING_APPLY schema v3.1: scope_policy=all_nodes + importance_breakdown 三级统计
skill-designer.md §6.5
- Step 3 写入策略分流:
- <20 patches: 多次 Edit (token 省)
-
=20 patches: Read -> 内存改 -> Write 整体覆盖 (避免 Edit 100+ 次 token 爆炸)
- 加伪代码 + JSON 序列化格式保留要求
- 严禁 '100+ patches 但只改前 10 个就交差'
CLAUDE.local.md
- 全节点 Desc 重写 v3.1 铁律段
- 历史 v3.0 -> v3.1 演化 (rule_2 思想史保留)
- AskUserQuestion 选项 2 文案动态化 (用 total_count 真实数字)
升级
cd D:\Unity\YourProject
npx fengshen-skillai@latest init . --force
v1.0.7 实战效果
下次 review 一个 100+ 节点的技能 / reviewer 会输出:
- importance_breakdown: P0=12 / P1=28 / P2=105 (让你预知工作量)
- patches[] 列全部 145 个节点 (按 P0/P1/P2 分级写)
- 主对话弹 ☑ '批量写入 145 个节点 Desc' 多选框
- designer 用 Read->Write 整体覆盖 (一次写完) + APPLY_DONE 摘要
v1.0.6 — hotfix: extract-from-source.js 永久修 plugin.json 回归
v1.0.5 用户跑 init 后 .claude-plugin/plugin.json 缺失 (e2e 测试自动捕获到):
根因: extract-from-source.js 末尾 fs.emptyDir(templatesDir) 清空 templates → 每次跑 extract 都会丢之前手动 cp 进去的 plugin.json。
修法: extract 脚本末尾自动同步 npm 包根 .claude-plugin/plugin.json → templates/_root/.claude-plugin/plugin.json (脚本固化 / 不再手动 cp)。
副作用: 0 (只是手动操作脚本化)
升级
cd D:\Unity\YourProject
npx fengshen-skillai@latest init . --force
v1.0.5 — review 工作流工业化 v3 (4 选项 + P0 一起修 + designer 6 步强制)
修复用户两个新发现的痛点:
- review 时主对话没用 AskUserQuestion 弹多选框 (用户希望看到截图里那种 4 选项 ☑ 多选界面)
- 同事用 minimax 2.7 review 后没真写入: 只新建空 sticky / 只改几个 desc / designer 偷懒
改动
skill-reviewer.md
- §0 v3 / 7 步工业化流程图
- 强制 multiSelect=true 4 选项 (sticky / node_desc / P0 / 全部不写)
- §8 PENDING_APPLY schema v3 / 4 个独立 payload 段
- 新增 p0_patches (含完整修法 change_json_path / old_value / new_value)
- excluded_problems (没明确修法的 P0 让用户自己改)
- caller_instruction 详尽 7 步 (含 AskUserQuestion JS 代码示例 + 反模式)
skill-designer.md
- 新增 §6.5 接收 APPLY_REWRITE 6 步强制规约
- 防 minimax / 较弱模型 嘴上说改实际没改 / 改一半就停 / 不输出 APPLY_DONE
- 工业化自检清单 (任一项打不上勾 = 任务不能算完)
CLAUDE.local.md
- 审后写入分发流程 v2 → v3
- 7 步工业化流程图 + Step 5 强制 AskUserQuestion JS 模板
- 反模式 6 条 (主对话严禁)
升级
cd D:\Unity\YourProject
npx fengshen-skillai@latest init . --force