安装

添加到你的 Claude Code skills 目录：

# Add to your Claude Code skills
git clone https://github.com/AIPMAndy/AndySoul

安全报告

已验证

上次扫描：—

{
  "status": "PASSED",
  "issues": []
}

README.md

AndySoul - AI Agent 核心操作指令

Name: AndySoul
Author: AIPMAndy

适用于 AI 编码 Agent（Claude Code、Codex、Cursor 等）的通用行为指南，结合了基础认知公理、马斯克的工程方法论和 Karpathy 的编码原则，旨在最大化执行质量并最小化常见的 LLM 错误。也欢迎加微信AIPMAndy一起探讨Agent技术及应用。

适用于：Claude Code、OpenAI Codex、Cursor 以及任何读取项目指令的 AI Agent。

中文 | English

这是什么

一套通用配置文件，让 AI 编码 Agent：

从第一性原理思考，而非表面类比
在实现前质疑需求
编写最小化、外科手术式的代码变更
系统性验证结果
透明地处理不确定性

兼容平台：

🤖 Claude Code（通过 CLAUDE.md）
🔧 OpenAI Codex（通过 .cursorrules 或系统提示词）
⚡ Cursor（通过 .cursorrules）
🎯 任何 AI Agent（任何读取项目指令的 Agent）

建立在三大支柱之上：

9 条认知公理（熵增定律、还原论、概率不确定性等）
马斯克 5 步工程法（质疑 → 删除 → 简化 → 加速 → 自动化）
Karpathy 4 大编码原则（思考先于编码、简洁优先、外科手术式修改、目标驱动执行）

适用人群

适合你使用，如果你：

希望 AI Agent 更系统地思考，减少错误
需要透明的推理和明确的不确定性处理
重视最小化、精准的代码变更，而非"改进"
需要目标驱动的执行和可验证的检查点
在数据完整性至关重要的项目上工作

这不是：

项目模板（无脚手架、无 CI/CD、无技术栈）
应用框架
领域特定指令的替代品

快速开始

# Claude Code 用户
curl -o CLAUDE.md https://raw.githubusercontent.com/AIPMAndy/AndySoul/main/CLAUDE.md

# Cursor / Codex 用户
curl -o .cursorrules https://raw.githubusercontent.com/AIPMAndy/AndySoul/main/CLAUDE.md

# 或浏览特定场景模板
curl -O https://raw.githubusercontent.com/AIPMAndy/AndySoul/main/TEMPLATES.md

如何使用

Claude Code

复制 CLAUDE.md 到项目根目录：

curl -o CLAUDE.md https://raw.githubusercontent.com/AIPMAndy/AndySoul/main/CLAUDE.md

Claude Code 会自动加载。

Cursor / Codex

复制为 .cursorrules：

curl -o .cursorrules https://raw.githubusercontent.com/AIPMAndy/AndySoul/main/CLAUDE.md

其他 AI Agent

复制内容并适配到你的 Agent 配置格式（系统提示词、指令文件等）。

定制化

编辑文件，添加你的：

技术栈和锁定依赖
项目特定规则和约定
团队工作流和 git 实践
领域知识和边界情况

文件是模块化的 - 保留适合你工作流的部分，移除不需要的。

文档

📖 模板集合 - 6 个针对不同场景的预配置模板
💡 使用示例 - 前后对比展示真实行为变化
🇨🇳 中文文档 - 完整中文文档

与众不同之处

大多数提示工程关注"如何编码"。这个关注**"如何思考"** 然后再编码：

认知基础：基于普世原则（熵、进化、涌现）而非编码惯例
质疑优先文化：系统性挑战需求（马斯克方法）
外科手术式精准：只触碰必须改变的（Karpathy 原则）
验证执行：每一步都有成功标准
透明的不确定性：从不猜测或美化数据

核心概念

第一性原理思维

剥离惯例和类比。从基本真理（物理、数学、逻辑）推导解决方案。

5 步执行优先级

质疑必要性
删除非必要项
简化剩余部分
加速周期
最后自动化

数据完整性

从不根据不清晰的图像猜测
从不为报告美化数据
始终展示计算过程
立即承认错误

外科手术式修改

每行变更都追溯到用户请求
完全匹配现有风格
不"改进"相邻代码
只清理你的修改产生的孤儿代码

示例

之前（典型 LLM 行为）：

用户："给登录表单添加验证"
AI：[添加验证 + 重构表单 + 更新样式 + 添加未使用的错误状态]

之后（使用 AndySoul）：

用户："给登录表单添加验证"
AI："我会添加邮箱/密码验证。计划：
1. 添加验证规则 → 用无效输入测试
2. 显示错误消息 → 测试错误显示
3. 无效时阻止提交 → 测试提交拦截

我还应该处理边界情况如空字符串吗，还是只做基本格式验证？"
[只做请求的修改，匹配现有代码风格]

查看 EXAMPLES.md 了解 5 个详细的前后对比。

权衡

这些指南偏向谨慎而非速度。它们设计用于：

非琐碎功能
生产系统
需长期维护的代码
多人协作项目

对于简单的拼写修复或单行修改，使用你的判断力。

Star 历史

如果这对你有帮助，请考虑给个 star ⭐

社区

分享成功案例：使用此模板
报告问题：Bug 报告模板
建议改进：改进建议模板

贡献

这是一个活文档。如果你发现改进点：

开 issue 说明你的使用场景
分享什么有效、什么无效
用清晰的推理提出补充

许可证

MIT - 自由使用、修改，无需署名。

致谢

Andrej Karpathy：揭示常见 LLM 编码失败模式
Elon Musk：5 步工程方法论
第一性原理思考者：认知基础

与 Anthropic、OpenAI、Cursor 或任何 AI 公司无关。
只是一个开发者让 AI 编码 Agent 更系统可靠的尝试。

支持项目

如果你觉得有价值：

⭐ 给仓库点星
🐦 在 Twitter/X 分享
💬 在 Issues 分享你的成功案例
🤝 通过 PR 贡献改进

常见问题

What is AndySoul?⌄

AndySoul is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by AIPMAndy. Andy's Soul - AI Agent 核心操作指令 | Universal core directives for AI agents (Claude, Codex, Cursor) - Cognitive axioms + Musk's methodology + Karpathy's principles. It has 85 GitHub stars.

Is AndySoul safe to use?⌄

Yes. AndySoul passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install AndySoul?⌄

Clone the repository with "git clone https://github.com/AIPMAndy/AndySoul" and add it to your Claude Code skills directory (see the Installation section above).

Are there alternatives to AndySoul?⌄

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh AndySoul against similar tools.

AndySoul

安装

快速入门