张翔
75 lines
4.3 KiB
Markdown
75 lines
4.3 KiB
Markdown
# 全局 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` 检查技能更新
|
||
|
||
### 协同优势
|
||
- **完整闭环**：形成项目管理→协作→执行→质量保障的完整开发闭环
|
||
- **质量保障**：通过技能协同确保代码质量和项目进度
|
||
- **效率提升**：系统化的工作流程减少重复劳动和错误
|
||
- **团队协作**：支持多人协作和任务分工管理 |