Skillget

AndySoul

agent
Security Audit
Pass
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 34 GitHub stars
Code Pass
  • Code scan — Scanned 1 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Andy's Soul - AI Agent 核心操作指令 | Universal core directives for AI agents (Claude, Codex, Cursor) - Cognitive axioms + Musk's methodology + Karpathy's principles

README.md

AndySoul - AI Agent 核心操作指令

License: MIT
GitHub stars
PRs Welcome

适用于 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）

建立在三大支柱之上：

  1. 9 条认知公理（熵增定律、还原论、概率不确定性等）
  2. 马斯克 5 步工程法（质疑 → 删除 → 简化 → 加速 → 自动化）
  3. 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 实践
  • 领域知识和边界情况

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

文档

与众不同之处

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

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

核心概念

第一性原理思维

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

5 步执行优先级

  1. 质疑必要性
  2. 删除非必要项
  3. 简化剩余部分
  4. 加速周期
  5. 最后自动化

数据完整性

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

外科手术式修改

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

示例

之前（典型 LLM 行为）：

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

之后（使用 AndySoul）：

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

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

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

权衡

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

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

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

Star 历史

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

Star History Chart

社区

相关工作

  • Karpathy 的观察：关于 LLM 编码错误的推文
  • 马斯克的工程方法论：来自 SpaceX/Tesla 制造的第一性原理思维
  • BMAD-METHOD：完整的 SDLC 工作流（PM → 架构师 → 开发 → QA）
  • claude-code-bmad-foundation：结合 Karpathy + BMAD 的模板

贡献

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

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

许可证

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

致谢

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

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

支持项目

如果你觉得有价值：

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

Reviews (0)

No results found