苏格拉底项目哲学

从需求澄清到设计共识

很多项目不是缺少实现计划，而是在进入实现前缺少稳定的设计标准。需求散落在聊天记录、临时文档和口头讨论里，目标、边界、取舍反复摇摆，最后容易变成“先做再说”。metaphysics 解决这个问题：通过苏格拉底式提问，把项目本质、成功标准、设计原则和不做什么整理成一份 philosophy document。它不是任务列表，也不是实现方案，而是后续架构决策的参考基准。

四层框架与协作流程

技能围绕四层展开：

• Ontology：明确“它是什么”，包括核心定义、与相似事物的差异、用户/干系人以及关键概念关系。
• Teleology：明确“什么算成功”，包括解决什么问题、完成标准、成功指标和度量方式。
• Methodology：明确“如何达成”，包括核心设计原则、优先采用的模式、权衡方式和决策框架。
• Boundaries：明确“它不是什么”，包括不解决的问题、拒绝的方法、适用范围和失效边界。

流程上，它会先查看现有文档、README.md、设计说明和近期提交，再逐层提问。问题通常一次只问一个，并优先使用选择题，帮助回答者快速做决定。当四层内容都澄清后，技能会先总结核心原则，等待确认，再生成文档并保存到 docs/metaphysics/YYYY-MM-DD--philosophy.md。

适用边界

这个技能适合项目启动、重构前对齐、跨团队沟通，或在引入 AI 协作前形成稳定约束。它不适合直接生成代码、拆解任务或输出实现计划；如果项目已经有明确规格，它更适合用来校准目标与边界，而不是替代 CLAUDE.md、设计文档或工程计划。