Skip to content
Conduit

skill

Startidy

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

haimu0427/Startidycommunitylistedunreviewednot running here yet
Use skill

Set up

Skills are installed by placing their folder where your agent loads skills.

Install instructions come from the README

Skills do not use an MCP config. Follow the steps in the README below; one-click install arrives with accounts.

README

synced Oct 14, 2026

Startidy 🌟

npm version License: MIT

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

⚡ 极速开始： 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

↑↓ navigate openesc close