Imported from BellyBook/amazing-agents (
AGENTS.md). Install upstream withnpx skills add BellyBook/amazing-agents. Copyright stays with the author.
大道至简: 万物生于有,有生于无。代码亦然——新功能当生于已有范式,非凭空造作。 少则得,多则惑。一系统若有七种错误处理、五套日志方案,则道已失矣。 善行无辙迹,善言无瑕谪。好代码不留痕迹,浑然天成,如水之就下。
无为之治: 不自生,故能长生。不自见,故明。不自是,故彰。不自伐,故有功。 写代码前先问:系统里有人解决过吗?有则遵循,无则以范式之标准创之。
法自然: 模型 → 观他模型之所居,遵其位、其名、其基 错误 → 察统一之报错规范,复用已有之错误类型 日志 → 循统一之日志方案,用已有之 logger,禁 console.log 之散乱 工具 → 探 utils/ 之所藏,扩已有而非另起炉灶 常量 → 归已有常量之所,禁魔法数字之惑 请求 → 用已有 HTTP 封装,禁裸写 fetch/axios 之蛮 状态 → 遵已有状态管理之道,禁混用方案之乱
验道: 十人同作,其代码若一人所书。此非束缚,乃大自由也。 道生一,一生二,二生三,三生万物。范式即道,万物从之。
Co-Authored-By: shizhi 350442340@qq.com EOF )"
GEB 分形文档系统协议
The map IS the terrain. The terrain IS the map. 代码是机器相 文档是语义相 两相必须同构 任一相变化 必须在另一相显现 否则视为未完成
<L1_TEMPLATE> L1 项目宪法
{项目名} - {一句话定位}
{技术栈用 + 连接} {目录}/ - {职责} ({N}子目录: {关键子目录}...) {文件} - {一句话用途} 法则: 极简·稳定·导航·版本精确 </L1_TEMPLATE>
<L2_TEMPLATE> L2 模块地图
{模块名}/
L2 | 父级: {父路径}/AGENTS.md 成员清单 {文件}.{ext}: {职责},{技术细节},{关键参数} 法则: 成员完整·一行一文件·父级链接·技术词前置 [PROTOCOL]: 变更时更新此头部,然后检查 AGENTS.md </L2_TEMPLATE>
<L3_TEMPLATE> L3 文件头部契约 /**
- [INPUT]: 依赖 {模块/文件} 的 {具体能力}
- [OUTPUT]: 对外提供 {导出的函数/组件/类型/常量}
- [POS]: {所属模块} 的 {角色定位},{与兄弟文件的关系}
- [PROTOCOL]: 变更时更新此头部,然后检查 AGENTS.md / 示例: /*
- [INPUT]: 依赖 @/ui/tokens 的 laperColors,依赖 react 的 useState/useEffect
- [OUTPUT]: 对外提供 AvatarGenerator 组件、useAvatarStyle hook
- [POS]: components/avatar 的核心渲染器,被 UserProfile 和 CommentItem 消费
- [PROTOCOL]: 变更时更新此头部,然后检查 AGENTS.md */ 法则: INPUT 说清依赖什么·OUTPUT 说清提供什么·POS 说清自己是谁 发现业务文件缺少 L3 头部,立即添加,阻塞级优先 </L3_TEMPLATE>