makerskills：给独立开发者的 AI 技能工具箱，把决策与知识管理变成可执行工作流

makerskills 是一个面向创始人和独立运营者的 AI Agent 技能插件集，提供 24 个开箱即用的技能模块，覆盖决策、研究、二脑、内容轮转、场景建模等核心工作流。采用文档优先设计，每个技能即文档又自动化，兼容 Claude Code、Cursor、Codex，帮助个人操盘手将碎片化认知转化为结构化资产。

适用人群：独立开发者与 Indie Hacker：需要在有限精力下同时处理产品、运营、决策等多角色任务；创始人与小团队负责人：寻找结构化方法辅助战略决策与知识沉淀；重度 AI 编程工具用户：希望在 Claude Code、Cursor 等环境中复用标准化技能模块

适用场景：面对关键岔路口时，调用 decide 技能引入 37signals 决策框架，生成带复盘日期的结构化决策记录；日常信息摄入过载时，配合 research 与 second-brain 技能将碎片笔记自动归档、关联、生成可检索知识库；内容运营节奏中，使用 content-rotation 与 paste 技能实现跨平台素材清洗、字符限制校验与定时发布排程

推荐理由：makerskills 最大的价值在于把“懂道理”变成“用得上”：每个技能都是一份可读可执行的 SKILL.md，零配置即可上手，又支持个人配置深度定制。它不造新轮子，而是把成熟框架（如 37signals 决策法、Zettelkasten 笔记法）封装成 Agent 可调用的原子能力，降低了将最佳实践落地到日常工作的门槛。对于追求复利式成长的个人操盘手，这是难得的“即插即用且可长期进化”的工具箱。

项目定位与背景

makerskills 由 Corey Haines 发起，定位为“个人操盘手的 AI 技能库”。不同于通用型 Agent 框架试图解决所有问题，它聚焦于创始人、独立开发者这类高语境、多角色、决策密集的群体。README 明确指出：Built for founders and indie operators。项目不追求构建一个全能的自主 Agent，而是提供 24 个粒度适中、单一职责明确的技能模块，每个模块对应一个具体的操作场景——决策、破局、研究、二脑、内容轮转、CFO 节奏、域名狩猎等。这种“技能即插件”的设计理念，契合了当前 AI 编程工具（Claude Code、Cursor、Codex）的插件生态演进方向。

核心功能与技术架构

项目采用 Python 实现，核心架构围绕“技能”这一原子单元展开。每个技能目录包含 SKILL.md（工作流文档）、入口脚本、必要的依赖声明。运行时通过 Claude Code 的 /plugin 机制或符号链接加载，环境变量 MAKERSKILLS_CONFIG 指向个人配置目录，实现插件与用户数据分离。技能调用方式统一为斜杠命令（如 /decide、/paste twitter），底层遵循“结构化输入 → 结构化输出 → 落盘归档”的闭环。以 decide 为例：它引入 37signals 决策框架的 37 个问题，交互式引导用户完成决策记录，并自动写入带复盘日期的 Markdown 文件。paste twitter 则演示了纯工具类技能：读取剪贴板、清洗格式、字符数校验、回写剪贴板，首次运行自动提示安装 pbcopy 等系统依赖。这种文档优先的设计意味着：即使不运行自动化，阅读 SKILL.md 也能手动执行完整流程，降低了对黑盒自动化的信任成本。

创新点与亮点

第一，文档即代码、代码即文档。SKILL.md 既是给人看的操作手册，又是给 Agent 读的执行规约，消除了文档与实现脱节的常见痛点。第二，零配置启动与渐进式配置并存。decide 等核心技能无需任何配置即可运行；涉及个人偏好的技能（如内容发布渠道、API Key）再引导用户建立个人配置，符合“先跑通再定制”的认知规律。第三，技能路由表。README 提供的“意图→技能”映射表，解决了功能数量增长后的发现性问题，用户只需对照当前任务意图即可定位技能。第四，生态中立。明确支持 Claude Code、Codex、Cursor 等主流 Agent 宿主，避免了厂商锁定。第五，元技能。项目包含 author-skill 等元技能，指导用户编写自己的技能，形成“使用→改造→贡献”的正向循环。

与同类项目对比

对比同类个人知识管理与 AI 工作流项目：Obsidian 插件生态（如 Dataview、Templater）侧重笔记内部自动化，缺乏跨工具调度能力；LangChain、AutoGPT 等框架面向开发者构建复杂 Agent，上手门槛高、调试成本大；Raycast、Alfred Workflow 等效率工具更偏向通用动作，缺乏领域化决策框架。makerskills 的差异化在于：它不是笔记软件插件，也不是通用 Agent 框架，而是“领域化技能包+宿主无关运行时”的中间层。它把成熟管理框架（37signals 决策法、Zettelkasten、CFO 复盘节奏）预制为可执行单元，让非全职开发者也能以极低成本获得结构化工作流收益。

上手指南与快速开始

按 README 的 5 分钟路径即可体验核心闭环：1) 在 Claude Code 中执行 /plugin marketplace add coreyhaines31/makerskills 并安装；2) 在 ~/.zshenv 设置 export MAKERSKILLS_CONFIG="$HOME/.config/makerskills" 并重载 shell；3) 直接运行 /decide 体验零配置决策流程；4) 阅读 ~/code/makerskills/skills/decide/SKILL.md 理解文档结构；5) 尝试 /paste twitter 感受工具类技能的交互；6) 浏览技能列表，挑选一个当前正在手动执行的工作流对应的技能深度接入。进阶阶段可按 INSTALL.md 配置个人模板、API 凭证、定时任务等。

总结与展望

makerskills 展示了 AI 时代个人生产力工具的一种务实范式：不追求通用智能体的全自动，而是将专家经验固化为可组合、可审计、可进化的技能模块。当前 24 个技能覆盖决策、研究、知识、内容、财务、域名等高频场景，随着社区贡献元技能的完善，技能库有望向垂直领域（如 SaaS 定价、SEO 内容、招聘面试）扩展。潜在挑战在于：技能间的组合编排尚未标准化，跨技能上下文传递依赖用户手动衔接；宿主环境差异可能导致边缘行为不一致。但总体而言，对于追求“把时间花在决策而非流程上”的独立操盘手，makerskills 是一个值得长期投入、随着职业生涯共同成长的基建级工具箱。