maggy

Maggy Skill

Maggy 是一个通用的本地 AI 工程指挥中心。安装一次，将它连接到团队的工单跟踪器和代码库，即可获得：

• AI 优先级收件箱——根据紧急程度、OKR 匹配度和新近程度对未解决工单排序
• 一键执行——在本地启动 Claude Code，并注入 iCPG 上下文
• 竞争对手情报——每日 AI 竞争格局简报
• 无需硬编码——适用于任何团队、任何技术栈、任何工单跟踪器

⚠️ 执行权限模型（重要）

Execute 当前运行 claude -p --dangerously-skip-permissions，以免 TDD 流水线因等待审批提示而受阻（子进程没有终端）。 此标志授予 Claude 在目标代码库中写入／编辑文件和运行 shell 命令的完整权限，而且它收到的提示词包含来自工单跟踪器的内容（任何团队成员都可以编写这些内容）。

已采取的加固措施：

• working_dir 会根据 ~/.maggy/config.yaml 中的代码库根目录列表进行验证，因此 Claude 无法被指向任意文件系统路径。
• 只有来自你配置的跟踪器的工单会传递给 Execute；不会有来自公共互联网的 输入进入提示词。

**路线图：**将此无条件标志移至每个代码库的配置项 （auto_approve: true|false），让特权执行改为由用户主动选择。 在此之前，请将 Execute 视同对你点击按钮执行的任何工单运行 git pull && make——只在自己拥有的仓库中运行，并且只处理 来自你信任的作者的工单。

┌──────────────────────────────────────────────────────────────┐
│  maggy               ──────────────┐                          │
│  ├── skills/         ← installed globally → ~/.claude/       │
│  ├── commands/       ← installed globally → ~/.claude/       │
│  ├── scripts/icpg/   ← used by Maggy for context enrichment  │
│  └── maggy/          ← dashboard: run `./install.sh` to use  │
│      ├── src/                                                │
│      │   ├── providers/   ← GitHub / Asana / Linear          │
│      │   ├── services/    ← inbox, competitor, executor      │
│      │   └── api/         ← FastAPI routes                   │
│      └── install.sh                                          │
└──────────────────────────────────────────────────────────────┘

---

Maggy 的适用场景

场景	Maggy 的作用
早上分流 50 个未解决工单	AI 为工单排序；优先级最高的始终排在最前
实施工单	Execute → 注入 iCPG 上下文的 TDD 流水线
“竞争对手在发布什么？”	每日简报 + 可筛选的新闻源
每个团队有多个仓库	根据工单内容自动选择合适的仓库
新团队入职	通过 /maggy-init 配置，无需编写代码

---

安装和配置

# One-time install
cd $(cat ~/.claude/.bootstrap-dir)/maggy
./install.sh

# Configure
# Edit ~/.maggy/config.yaml — see maggy/config.example.yaml for the schema

# Credentials
export GITHUB_TOKEN=ghp_...
export ANTHROPIC_API_KEY=sk-ant-...

# Run
python3 -m src.main

# Or from Claude Code:
#   /maggy-init    # interactive wizard
#   /maggy         # launch dashboard

---

服务提供方抽象

Maggy 服务不会直接访问 GitHub／Asana，而是通过 IssueTrackerProvider Protocol 与其交互。可直接替换为：

• GitHubIssuesProvider——扫描多个仓库、汇总未解决工单，并将“已完成”映射为已关闭
• AsanaProvider——查询项目，并遵循工作区范围
• LinearProvider——供未来使用的存根

相同的收件箱、Execute 流水线和竞争对手功能适用于任何服务提供方。

---

Execute 流水线

在工单上点击 Execute 时：

1. Maggy 查询已配置的 iCPG，获取相关符号、影响范围和先前意图
2. 根据工单关键词和已配置的代码库，选择合适的工作目录
3. 在该目录中启动 claude -p --dangerously-skip-permissions
4. 依次执行分析 → 编写失败测试 → 实现
5. 将输出保存到会话中，你可以在 Sessions 标签页跟进

由于启动的 Claude Code 在目标仓库中运行，它会读取：

• 该仓库的 CLAUDE.md
• 你的全局 ~/.claude/CLAUDE.md
• 所有引导技能
• .claude/hooks/、.mcp.json

因此，Execute 可以获得完整的引导体验，而非精简版。

---

竞争对手情报

通用功能——适用于任何领域：

1. 在 ~/.maggy/config.yaml 中配置 competitors.categories: ["fintech", "embedded-finance"]
2. 点击 Discover——Claude 会识别 12～18 个竞争对手（市场领导者、AI 优先的挑战者、垂直领域专家）
3. Maggy 每日监控他们的 RSS 博客和 Google News
4. 每日简报每天生成一次（会缓存），也可以按需重新生成

---

不包含的功能

Maggy MVP 专注于核心功能，尚未提供：

• 会议机器人（语音）
• Slack 集成
• P2P 网络 + 会话交接
• 自我改进（/improve-maggy）
• Linear 服务提供方（仅存根）

这些属于 v2 的工作。

---

Files

• maggy/PLAN.md — architecture rationale
• maggy/README.md — user docs
• maggy/src/providers/base.py — IssueTrackerProvider Protocol
• maggy/src/services/executor.py — TDD pipeline
• maggy/src/services/competitor.py — discovery + briefing
• maggy/src/services/inbox.py — AI prioritization
• commands/maggy.md — /maggy launcher
• commands/maggy-init.md — /maggy-init setup wizard