vision Skill：用代码历史挖出真实项目价值观的 Agent 技能

Skill超级捕获手 技术创作者 2026-08-24 10 阅读

总结

vision 是一个 Agent Skill，帮助团队从真实代码历史（合并的 PR、提交记录）中挖掘项目价值观，自动生成一份可测试的 VISION.md 文档。与空想式愿景不同，它要求每条原则必须引用真实 merged PR 或 commit，拒绝虚构——用证据而非感觉来定义项目 identity。2026-08-09 上线，截至 2026-08-24 约 286 颗星，增长迅猛，是近期值得关注的新晋 Skill。

功能与原则

vision 的核心功能是从代码库历史中提取项目真实决策，生成结构化的 VISION.md 作为团队和 AI Agent 的共识基准。它的设计原则有三：

  • 证据优先：每条原则必须引用真实 merged PR 或 commit，禁止空泛的工程美德宣言。若历史不可读，Skill 会直接拒绝而非自行编造。
  • 压力测试而非头脑风暴：生成 8-12 个”断层假设”场景（诱惑但偏离使命的特性、原则碰撞、滑坡问题），双方都要钢化论证；可预测的答案会被替换。
  • 互动审核板：答案以卡片堆栈形式逐张展示，正面为判断（是/否+理由），翻转揭示下一张，最终所有追溯性编辑被合并回文档。

认可度

  • GitHub Star：约 286（截至 2026-08-24），创建于 2026-08-09，上线 15 天即达到此数，增长曲线陡峭
  • 定位：GitHub 搜索显示 2026-08-01 后创建的 SKILL.md 相关仓库中排名前列
  • 分发渠道：通过 npx skills add kunchenguid/vision -g 安装，已进入 agentskills.io 官方 Skill 目录

链接

GitHub：https://github.com/kunchenguid/vision

原作者

kunchenguid（GitHub @kunchenguid）— 专注于 AI Agent 工具链与开发者体验的项目维护者，同名维护了 firstmate 等多个 Agent 相关项目。其 vision Skill 的产品思路来源于长期观察团队在 AI 时代”反复重新谈判项目方向”的痛点。

介绍

很多团队在项目初期写过 Mission Statement 或 README，但很少有人真的去问：这段历史说明了什么价值观？当你用上 AI 编程助手，它往往按自己对”好代码”的理解来工作，而不是按你团队沉淀下来的规范。

vision 尝试解决这个问题。它的工作流程是：先学习 pattern（参考真实项目 VISION.md 的写法）→ 分析目标 repo 的合并 PR 或 commit 历史 → 从中抽取 identity、principles、non-goals → 起草 VISION.md 并进行假设验证 → 在互动审核板上逐张裁定，最终输出一份有出处的、经过压力测试的 VISION.md 和对应答案记录。

最终产物示例见 firstmate 的 VISION.md，即通过 vision 流程生成的实际文档。文档包含 identity（身份定位）、principles（原则清单，每条附证据）、non-goals（主动拒绝的范围）和 aligns/resisted tests（压力测试场景及答案）。

特点

  • 证据驱动：原则必须有真实 merged PR 或 commit 可引用，无历史依据时 Skill 拒绝生成
  • TLA+ 形式化验证：code-review-loop 等核心流程附带 TLA+ 状态机验证，确保协调协议正确性
  • 无宿主依赖：不依赖特定 Agent 工具，任何读取 SKILL.md 的 harness（Claude Code、Codex、Cursor 等）均可使用
  • 互动审核板：基于 lavish-axi 的卡片式审核界面，答案可追溯，每张卡片翻转后更新文档
  • 安装极简：一行命令 npx skills add kunchenguid/vision -g 完成全局安装，会话内输入 /vision 即可触发

使用方法

安装（全局）：

npx skills add kunchenguid/vision -g

在 Agent 会话中触发：

# 当前仓库
/vision

# 指定其他仓库
/vision owner/repo

# 自然语言触发
"help me write a VISION.md for this project"

本地编辑 Skill 文件：

$EDITOR skills/vision/SKILL.md

本地测试发现：

npx skills add ./ -l

Skill 会自动读取仓库的合并 PR（通过 gh 或 gh-axi，若不可用则降级到 git commit 历史）作为证据来源，并通过 lavish-axi 渲染审核界面。

使用场景与人群

  • 适用场景：新项目启动时的价值观对齐、中大型团队引入 AI 编程助手前的规范建立、现有项目需要将隐性决策显性化
  • 目标用户：技术负责人、架构师、工程效能团队；希望 AI Agent 遵循团队独特规范而非通用偏好的开发者
  • 典型时机：在 /vision 的 slash command 被调用时，或用户表达”帮我写/完善项目愿景”意图时自动触发

输入与输出案例

输入（Agent 执行 /vision）：

/vision
（Agent 分析 repo 历史：merged PRs → evidence sheet → draft VISION.md）

输出（部分示例）：

一份 VISION.md 包含：

  • Identity：”我们是做 X 的，不做 Y，因为 Z 历史决策”
  • Principles：每条格式为 [原则名]：<描述>，证据：<PR#123：解决了某问题>
  • Non-goals：”我们不做社交功能，因为 PR#456 主动拒绝了这个方向”
  • Stress tests：Q: 如果要做短视频功能我们会有什么风险？A: 违背 Non-goal #2，建议拒绝

最终生成的文件示例：firstmate/VISION.md

GitHub: https://github.com/kunchenguid/vision

评论区

0 条评论

登录后可评论。

Skill超级捕获手 10 阅读