Skillget

Startidy

agent
Security Audit
Fail
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 20 GitHub stars
Code Fail
  • os.homedir — User home directory access in src/adapters/file-store.ts
  • process.env — Environment variable access in src/adapters/file-store.ts
  • spawnSync — Synchronous process spawning in src/cli/doctor.ts
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Turn messy GitHub Stars into organized Lists automatically with AI agent skills and npm CLI.

README.md

English | 简体中文

Startidy 🌟

npm version
License: MIT

Contract-driven GitHub Stars organizer for AI agents and developers.
让 AI Agent 帮你自动分类、整理混乱的 GitHub Stars 到 GitHub Lists 中，安全、增量且完全受控。

GitHub Lists 实际整理效果 AI Agent 执行与原子校验
(左：AI 整理后的效果 / 右：AI Agent 执行过程中)

⚡ 极速开始： AI Agent 驱动

如果你正在使用 Claude Code / Cursor / Codex / Antigravity，把下面这段 Prompt 复制发送给你的 Agent：

🤖 复制发给 Agent 的一行流指令：

请帮我初始化 GitHub Stars 整理工具 Startidy：先运行 npm install -g @haimu0427/startidy 并执行 startidy doctor 检查环境；接着读取并加载仓库 https://github.com/haimu0427/Startidy 中的 skills/startidy/SKILL.md（如果在本地已克隆则读取本地文件）；配置完毕后向我汇报就绪状态，并等待我发出整理 Stars 的具体指令。

初始化后，发送指令：“请帮我分析我的 GitHub Stars，并规划一份合理的分类列表帮我整理。”

💡 为什么需要 Startidy？

随着 Star 的仓库越来越多（几百甚至数千个），GitHub 官方的 Lists 整理起来费时费力。普通脚本要么容易误删分类，要么需要把敏感 Token 喂给第三方大模型。

Startidy v2 采用全新的“Agent + 契约驱动”模式：

  1. Agent 负责大脑，CLI 负责手脚：由日常使用的 ai agent 驱动，负责语义理解与分类规划。
  2. 严格的契约保障（Contract-Driven）：通过 JSON Schema 严格校验输入输出，杜绝 AI 幻觉引发的破坏性操作。
  3. 安全三步走（Snapshot → Preview → Apply）：每次操作前生成清晰的变更预览（Review），只有用户确认后才会执行。

🛠️ 手动安装与使用 (Manual Setup)

如果你习惯在终端手动操作，仅需以下 3 步：

1. 环境准备与安装

运行 Startidy 需要 Node.js (>= 22) 与已登录的 GitHub CLI (gh)。

前置：安装并登录 GitHub CLI

#参见: https://cli.github.com/

# 登录 GitHub 账号并授权
gh auth login

安装 Startidy

方式 A：通过 npm 全局安装（推荐）

npm install -g @haimu0427/startidy
# 或无需安装直接通过 npx 运行
npx @haimu0427/startidy doctor

方式 B：从源码本地构建

# 克隆仓库
git clone https://github.com/haimu0427/Startidy.git
cd Startidy

# 安装依赖并构建
bun install
bun run build

# 链接到全局命令行 (可在任何目录使用 startidy 命令)
bun link   # 或使用 npm link

验证环境状态：

startidy doctor

2. 载入 Agent Skill

Startidy 在 skills/startidy/ 目录下提供了符合标准的 Agent Skill，支持各种主流 AI 终端：

  • Claude Code: 将 skills/startidy 软链接或复制到 .claude/skills/startidy
  • Codex / ChatGPT / Antigravity: 软链接或复制到 .agents/skills/startidy
  • Cursor: 在项目技能/Rules 中引入 skills/startidy/SKILL.md

3. 三阶段执行流程

  1. 读取状态：执行 startidy snapshot 获取当前所有 Stars 和 Lists 快照。
  2. 语义规划 & 预览：Agent 根据仓库简介自动归类生成 plan.json，并调用 startidy preview 生成变更预览供用户审核。
  3. 安全应用：用户确认方案满意后，Agent 执行 startidy apply 安全同步至 GitHub。

📖 CLI 常用指令参考

命令 用途 关键参数
startidy doctor 检查 Node、gh 登录态和依赖环境 --json
startidy snapshot 抓取当前所有 Stars 与 Lists 快照 --out <file>, --json
startidy details 批量拉取候选仓库的 README 补充信息 --snapshot <file>, --candidates, --limit 20
startidy preview 校验分类计划并生成变更预览 diff --snapshot <file>, --plan <file>, --out <file>
startidy apply 执行已经校验的变更或恢复中断任务 --review <file>, --resume <runId>
startidy status 查看指定运行任务的执行日志与状态 --run <runId>
startidy resolve 处理由于网络或冲突阻断的异常状态 --run <runId>, --action <adopt/retry/abort>

🤝 致谢 (Acknowledgements)

本项目基于并灵感源自 @hellosunghyun 的开源项目 hellosunghyun/startidy。

v2 版本进行了彻底重构：不再需要配置外部大模型 API，而是直接配合你日常使用的 AI 助手进行分类规划；执行过程提供严格的数据校验、变更预览与断点续传能力。感谢原作者!

📄 License

MIT License © 2024 hellosunghyun & © 2026 haimu0427

Reviews (0)

No results found