notes-skills

AI Programming Toolkit

个人 AI 编程工具集 - Skills、Plugins、MCP Servers 等

个人维护的 AI 编程相关工具集合，包含 Claude Code Skills、插件、MCP 服务器等，用于提升 AI 辅助编程效率。

Quick Install

/plugin marketplace add z-soulx/ai-toolkit
/plugin install image-alt-title-filler@z-soulx

新手知识

Agent（智能体）：负责“理解目标 → 拆解计划 → 调用工具 → 读结果 → 再迭代”的执行体（带状态、会规划、会行动）。

• 勘误： Agent 的“执行体”一定是一个 runtime（CLI/SDK/程序），可以是（Python/TS）来写“你自己的 Agent 程序”，也可以用文件声明Subagent(但依赖主agent CLI本身，CLI就是一个agent执行体agentic runtime)。
• subagent相比skill 一个“分身”，独立上下文、独立权限/工具集，专门跑一类任务（比如 code review）。 可以把“噪音”隔离在子上下文里，主对话只拿总结

Tool（工具）：确定性的能力接口（读写文件、跑命令、查 API、访问数据库……）。

• 内置 tools 和 利用MCP扩展tool(:bulb: Tool 和 MCP 不是同一层的概念,着重利用)。

Command：Slash command（/xxx）是“你手动触发的快捷指令 / 提示词模板 / 控制面板”

MCP：让 agent/LLM 以标准方式连接到外部工具与数据源的“通用插口/协议”（客户端 ↔ 服务器）。

Skill（技能）：把你团队/你个人的“做事流程与专业知识”封装成可复用模块，让 agent 更会做这类事。

Hook（钩子）：在 agent/工具链生命周期的关键节点插入“必定执行”的规则/脚本，用来做强约束、审计、自动化。

Rule（规则）：放进 system prompt 的持续约束，会话启动即生效，不需要触发——与 Skill（按需注入）的核心区别是"在静态前缀里还是动态上下文里"。含 AGENTS.md / CLAUDE.md / prompt 加载机制详解 ｜ Context 管理与压缩机制指南

Plugin（插件）：把 skills / hooks / agents / slash commands / MCP servers 等打包成可分发、可版本化、可团队复用的一套扩展。

目录结构

ai-toolkit/
├── .claude-plugin/
│   └── marketplace.json  # Marketplace 定义
├── commands/             # Slash 命令（显示在命令列表中）
│   ├── learning-notes-organizer.md
│   ├── image-alt-title-filler.md
│   ├── note-outline-checklist.md
│   └── section-refactor-with-todo-routing.md
├── skills/               # Claude Code Skills（详细工作流）
│   ├── notes/            # 笔记整理相关
│   ├── productivity/     # 生产力工具
│   └── doc-processing/   # 文档处理（docs-writing-protocol / prd-maintenance）
├── rules/                # 行为规则模板（约束 AI 行为）
│   ├── docs-writing-protocol/  # 文档沉淀写入协议
│   ├── prd-maintenance/        # PRD 渐进式维护协议
│   └── feedback-after-completion/  # 任务完成后强制交互反馈
├── docs/                 # 参考文档
│   └── context-management.md  # Context 管理与压缩机制指南
├── plugins/              # 编辑器插件和扩展
├── mcp-servers/          # Model Context Protocol 服务器
└── README.md             # 本文档

综合参考源

• 综合源-everything-claude-code

Skills

Claude Code 自定义技能，用于特定工作流。

笔记整理 (notes/)

• learning-notes-organizer - 学习笔记系统化整理
• image-alt-title-filler - 图片 alt/title 批量补全
• note-outline-checklist - 笔记大纲生成
• section-refactor-with-todo-routing - 章节重构工具

生产力工具 (productivity/)

• markdown-to-pdf - Markdown 转专业 PDF 白皮书（苹果设计风格）
  • 基于原版改造升级

文档处理 (doc-processing/)

• docs-writing-protocol - 文档写入协议（去躁点版）

  • 按需写入，没点名文件就不写入
  • 纠错不记账，只记契约/流程/规则/语义变更
  • 对应 Rule：rules/docs-writing-protocol/（高频场景可改用 Rule 全量加载）

• prd-maintenance - PRD 渐进式维护协议

  • 三层结构：Facts（冻结）+ Snapshot（当前）+ Changelog（历史）
  • 供应商隔离，渐进演进（单文件 → 拆分）
  • 对应 Rule：rules/prd-maintenance/（高频场景可改用 Rule 全量加载）

外部 Skills

:registered: 本项目已经引入仓库，可直接安装skill无需单独再加入市场

:registered: planning-with-files - 任务规划和进度跟踪

• 解决ai易在长上下文中迷失，出现”幻觉“或遗忘。

:registered: superpowers - 头脑风暴、写计划、执行计划

• An agentic skills framework & software development methodology that works.

codebase-to-course - 将项目变成可学习课程

andrej-karpathy-skills - 减少对 LLM 编码陷阱

Rules

行为规则模板——放进 system prompt，会话启动自动生效。Rule / AGENTS.md / CLAUDE.md / prompt 加载机制

• prd-maintenance - PRD 渐进式维护协议（多供应商并行 + 敏捷迭代）
• docs-writing-protocol - 文档写入协议，控制何时写入、写什么，避免文档噪声
• feedback-after-completion - 任务完成后强制调用 MCP 询问用户反馈

cp rules/<rule-name>/RULE.md your-project/.claude/<rule-name>.md

Agents

Plugins

编辑器插件和扩展（待添加）

• anthropics官方插件列表

ralph-wiggum - Ralph 就是一个 Bash 循环,自我纠正修复

• ⚠️--max-iterations 设置最大迭代次数，否者遇见死题上演token消失术。

MCP Servers

Model Context Protocol 服务器（待添加）

notebooklm-mcp - NotebookLM笔记操作，但是不支持上传文件

sequential-thinking - 通过思维序列动态地、反思性地解决问题。

使用说明

手动安装 Skills

# 复制 skill 到 Claude Code 配置目录
cp -r skills/notes/learning-notes-organizer ~/.claude/skills/

# 或使用软链接（推荐开发时使用）
ln -s $(pwd)/skills/notes/learning-notes-organizer ~/.claude/skills/

使用 Skills

在 Claude Code 中使用 / 命令调用已安装的 skills。

License

MIT License - 详见 LICENSE 文件

---

维护者: @soulx 最后更新: 2026-03-16