finding-unknowns-skills

让 AI 代理先问清楚再写代码,少返工

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 编程开发 🍴 复刻 31
GitHub ↗
GitHub 星标 ★ 372
维护状态 维护中
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自行安装到Claude Code等环境

项目预览

finding-unknowns-skills 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类编程开发
开发团队Neeeophytee
定价模式🏷️完全免费
价格说明开源免费,需自行安装到Claude Code等环境
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型agent-skills,ai-agents,claude,claude-code,codex,cursor,hermes-agent,kimi-k3,openai-codex,prompting,skills
GitHub 星标★ 372
上线时间2026-07-05 00:00:00
代码更新2026-09-28
仓库体积173 KB
本站数据更新2026-11-13
维护状态维护中
收录时间2026-09-30
浏览次数3

项目介绍

finding-unknowns-skills 是一套面向 AI 编程代理的可安装技能包,包含 14 个技能,适配 Claude Code、OpenAI Codex 和 Hermes 等主流代理环境。它解决的核心问题是:AI 代理在写代码前往往不清楚需求边界、隐藏约束和未知假设,导致返工和错误修复。项目通过结构化提示流程,让代理主动发现未知项、澄清需求、管理上下文、验证假设,并在修 bug 时用回归证据确认修复有效。每个技能都是可独立安装的提示模块,用户按需组合,无需改动代理本身。适合把 AI 代理从“直接写代码”升级为“先想清楚再动手”的工作流,尤其适合需求模糊、上下文复杂或 bug 反复出现的开发场景。项目用 Python 实现,当前处于早期阶段,星标约 339。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-30 · 当前星标 ★ 372

使用教程

ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。

难度:入门 约 20 分钟 部署方式:skills CLI 4 步

环境要求

  • 支持 SKILL.md 的 agent(Claude Code / Codex / Kimi CLI)

安装与启动步骤

  1. 1装技能

    一条命令装进当前 agent

    npx skills add Neeeophytee/finding-unknowns-skills
  2. 2先跑澄清

    让它先把不确定的地方列成问题,再动手

  3. 3按技能走

    12 个技能对应不同阶段:澄清、验证、收敛

  4. 4看兼容性

    不同 agent 触发方式有差异,看 COMPATIBILITY.md

如何确认成功

让它改一个陌生仓库时,会先输出待确认问题清单,而不是直接写代码。

注意事项

  • 解决的是「模型不知道你不知道什么」的问题,靠强制澄清把返工前置。
  • 内容整理自公开文章,仓库自己声明不是 Anthropic 官方项目。
  • 技能是提示词约束,模型不照做时没有任何硬性拦截。
  • 问题清单太长会拖慢节奏,小改动可以只用其中两三个技能。
  • 适合陌生代码库接手与需求含糊的场景,明确的小任务上收益不大。

核心亮点

  • 14 个技能按需安装,覆盖发现未知、澄清需求、上下文管理、假设验证、回归证据等完整环节
  • 同时适配 Claude Code、OpenAI Codex、Hermes 等多个代理,不绑定单一平台
  • 每个技能是独立提示模块,可组合进现有工作流,不需要修改代理源码

不足之处

  • 项目处于早期,技能效果高度依赖底层模型能力,实际收益缺少公开基准数据
  • 文档和社区生态尚在起步,长期维护和跨代理兼容性有待观察

适用场景

  • 需求模糊时让 AI 代理先列出未知项并提问,再开始编码
  • 复杂项目中管理上下文,避免代理遗忘关键约束
  • 修复 bug 后要求代理提供回归证据,确认问题真正解决

替代项目

SuperClaude、claude-code-templates

上一篇:claude-night-market

下一篇:Calyx

同类项目推荐

aver 开源

让 AI 写的代码,每一行都能被审计和信任

Aver is a programming language for auditable AI-written code

★ 66 2026-08-09
DeepCopilot 开源

在 VS Code 里用 DeepSeek 免费平替 Copilot,自动补全代码

Copilot-style AI coding agent for VS Code, powered by DeepSeek V4.

★ 79 2026-08-09
harmony-next.skills 开源

让 AI 助手离线学会鸿蒙开发,问答即出代码

Offline HarmonyOS NEXT developer skill library for AI coding assistants. Covers API ···

★ 369 2026-09-23
codexmate 开源

一个面板管住多个 AI 编程助手的聊天记录

Find, browse, and export conversations across AI coding tools. A local-first CLI + W···

★ 356 2026-11-05
Vibe_coding_guide 开源

把 AI 编码从野路子变成正规军,一套流程管到底

中文优先的 Vibe Coding / AI coding engineering workflow guide: specs, agents, worktr···

★ 245 2026-08-09
Gito 开源

AI 自动审查 PR,精准揪出漏洞和坏味道

An AI-powered GitHub code review tool that uses LLMs to detect high-confidence, high···

★ 471 2026-08-09
codexqa 开源

给 AI 编程助手装上质量检查技能,改完自动查影响、审代码、生成测试

codexqa: 11 local-first Agent Skills for Cursor, Claude Code, Codex & OpenClaw — ch···

★ 238 2026-10-03