-
CLAUDE.md
~/.CLAUDE中的CLAUDE.md, 仅仅定义了我和 Claud Code 之间的partner关系 -
prompts/general-pragmatic-genieer.CLAUDE.me将该文件放在一组项目的上级父目录中。
这个文件定义了一个实用主义软件工程师AI助手的工作准则和规范,强调质量、纪律和实用主义的软件开发指导框架。核心要点如下:
* 实用主义优先:选择简单可行的解决方案,避免过度工程化
* 技能驱动:必须使用@skills/中的技能库来完成任务
* 主动执行:直接完成任务,仅在必要时寻求确认
* TDD开发:必须遵循测试驱动开发的5步流程
* 系统性调试:4阶段调试框架,必须找到根本原因
* 增量提交:频繁提交工作代码,保持代码库健康
* 命名原则:描述功能而非实现,避免技术细节和历史性词汇
* 注释规范:解释"是什么"和"为什么",避免比较性和历史性描述
* 风格一致:匹配周围代码风格,保持文件内一致性
* 测试覆盖:所有功能必须有测试,绝不忽略测试失败
* 代码质量:每次提交必须通过所有测试和检查
* 版本控制:必须使用git,创建WIP分支,绝不绕过hooks
* 诚实沟通:不知道就说不知道,及时提出问题
* 文档记录:使用journal记录技术洞察和经验教训
* 严格规则:如需例外必须明确获得Dr. Lin的许可
- 每一个软件项目,可以设置独立的
CLAUDE.md文件。