novalon-manage-system/AGENTS.md

全局 Agent 规则

本文件用于约束自动化代理在本机工作区中的默认工作方式，并将 Superpowers 作为主工作流体系按需激活。

指令优先级

• 默认以 Superpowers 作为主工作流体系，但不默认启用 full Superpowers。
• 只读分析任务可不进入完整实现流程，但结论必须清晰、可追溯。
• 若用户明确要求 continue nonstop，默认持续推进，直到满足验收标准或出现真实阻塞。

默认原则

最短路径与并行轻重分流

• 默认采用“满足质量要求的最短路径”。
• 能直接完成并验证的，不升级为更重流程。
• 能用轻量 planning 解决的小任务，不升级为重文档流程。
• 能用单一专项 skill 解决的问题，不扩展为 full Superpowers。

轻量任务默认策略（Codex / Superpowers）

• 轻量任务：单文件或小范围修改、明确 bug 修复、配置 / 文案调整、小测试补充、局部 文档修改。
• 默认可跳过完整 brainstorming、writing-plans、using-git-worktrees 与重 review 链，直接实现并做定向验证；仅在关键不确定且无法从当前对话、项目上下文、AGENTS.md、现有代码回答时才提问。
• 总原则：将 Superpowers 视为可调节的工程纪律层——小任务走轻量路径，中任务保留简短 brainstorming 与短计划，大任务再启用完整流程。

流程升级 / 降级

• 升级到更重流程：影响边界超出初始判断、涉及公共 API / schema / 持久化 / 并发 / 共享逻辑、需求仍不清晰、验证覆盖不足、任务演变为中大型实现或重构。
• 降级到更轻流程：改动局部且边界清晰、不涉及共享核心逻辑、验证直接、补长计划或补 测试的成本明显高于收益、问题已收敛为单点修复。

Step by Step Reasoning Workflow

执行原则

1. 先澄清，再实现；先缩小边界，再扩展范围。
2. 优先局部修改与最小充分实现，避免无关扩张。
3. 若复杂度上升，及时升级流程，而不是硬撑轻流程。
4. 若任务已收敛为局部改动，及时降级流程。

编码质量原则（Karpathy Guidelines）

在编写、审查或重构代码时，遵循以下原则：

1. 编码前先思考 — 明确假设，不隐藏困惑，展示权衡
2. 简单优先 — 只写解决问题的最小代码，拒绝过度抽象
3. 精准修改 — 只触碰必须修改的部分，不"改进"相邻代码
4. 目标驱动执行 — 定义可验证的成功标准，循环直到验证通过

技能协同迭代项目工作流

技能组合策略

基于 Superpowers-ZH 技能框架，推荐以下技能协同组合用于复杂项目迭代：

核心技能组合

• gsd - 综合性项目管理系统，适用于个人开发者使用 Claude 代理进行任务管理、进度跟踪和项目规划
• gstack-workflow-assistant - 工作流助手技能，提供结构化的工作流程支持，适用于团队协作、任务分配和项目分工管理
• superpower-zh - 技能框架，提供 27 个专业技能的集成管理
• karpathy-guidelines - 编码质量指南，避免过度复杂化，确保代码简洁有效

协同工作流程

项目规划 (gsd) → 工作流管理 (gstack-workflow-assistant) → 技能执行 (superpower-zh) → 质量检查 (karpathy)

适用场景

• 复杂软件项目开发
• 需要严格质量控制的迭代过程
• 跨团队协作项目
• 长期维护的项目

使用建议

1. 项目启动阶段：使用 gsd 进行项目规划和任务分解
2. 团队协作阶段：使用 gstack-workflow-assistant 进行任务分配和分工管理
3. 开发执行阶段：使用 superpower-zh 中的具体技能（如 TDD、代码审查等）
4. 质量保障阶段：使用 karpathy 进行代码质量检查

技能安装与更新

• 所有技能已全局安装，支持 Trae、Trae CN 等 45 个代理
• 技能列表维护在 .trae/rules/superpowers-zh.md 中
• 定期使用 npx skills check 检查技能更新

协同优势

• 完整闭环：形成项目管理→协作→执行→质量保障的完整开发闭环
• 质量保障：通过技能协同确保代码质量和项目进度
• 效率提升：系统化的工作流程减少重复劳动和错误
• 团队协作：支持多人协作和任务分工管理