Friday Skills

为 Friday AI 提供的 Agent Skills：把「需求 → 可追溯 MR」的自动化能力带进 Cursor / Claude Code / Codex / Gemini CLI / OpenCode 等本地 AI 助手。

npm 包：@friday-ai-codes/skills。自带中文安装向导（不依赖第三方 skills CLI），也是一个 Claude Code 插件（skills + SessionStart hook + 捆绑 MCP server 声明）。

设计

• 好记：7 个 skill，全部 friday 开头、一个词收尾，按用户意图划分职责。
• 中文优先：skill 正文与描述全部 zh-CN，名字保留英文 slug。
• MCP 优先：细粒度能力（42 个工具）全部由 @friday-ai-codes/mcp stdio server 提供；skill 负责编排、护栏与轨迹纪律，HTTP 直调仅作兜底。
• 配置下沉 CLI：安装、配置、连接、修复全部由 CLI 完成（mcp setup 交互式向导），不再需要 setup 技能。

Skills（7 个）

| Skill | 用途 | | --- | --- | | friday | 总入口：技能路由表 + 轨迹纪律 + 环境未就绪指引；也可直接把任意需求交给它一条龙跑完（hook / Cursor rule 自动注入） | | friday-dev | 本地开发上下文面：在本地分支上问「开发到哪一步了 / 继续开发 / 现在有什么问题 / PRD·feature list」时，按当前分支召回 Friday 项目上下文；编码开工先召回、收工沉淀回写 | | friday-routing | 由 feature list / PRD 出仓库路由与落点判定矩阵：目标仓库（含 monorepo 子应用）→ 落点文件 → 新增/改造 → 证据 → 置信度；判不准主动带选项批量问，不猜 | | friday-solution | 由 feature list 出技术方案：判定功能点新增 / 改造 → 确认关联仓库 → 分仓 + 整体方案（含落点文件与伪代码）。关联仓库必须经用户确认 | | friday-code | 远端已索引仓库：找仓库 → 分析 → 计划 → 执行/MR，可分阶段也可一条龙 | | friday-feishu | 飞书工作项闭环：读上下文 → 技术方案 → 多仓执行 → 结果回写，可分阶段也可一条龙 | | friday-memory | Friday 的记忆层：LearningCase 经验记录/检索 + 交付知识检索（相似需求、版本时间线、关联链、as_of） | | friday-blueprint-stages | 技术方案编排环节单跑：需求规格 / 三分量仓库路由 / 沙箱仓库调研三个环节可基于上游产物单独触发（dry-run 提案），仓库集写回项目关联必须经用户显式裁决 |

Subagents（2 个）

Skill 教主 agent「怎么做」，subagent 让宿主把整段流程委托出去——本地 subagent 只当薄壳司机（发起 → 转达澄清 → 轮询取件），重活全在 Friday 服务端编排，主对话上下文不被轮询与海量中间结果污染。安装器会把它们装进 Cursor / Claude Code 的原生 agents 目录（其余 agent 无 subagent 机制，自动跳过，由 skill 正文引导主 agent 直接驱动）：

| Subagent | 职责 | 关键约束 | | --- | --- | --- | | friday-plan | 技术方案编排专员：驱动 feature tech plan 三段链（发起 → 确认 → 轮询取件）与飞书蓝图澄清链（取件 → 逐条作答 → 续取终稿） | 一次性无状态调用；待确认问题 / 待澄清题原样带回，绝不代用户作答；轮询超限如实返回 session_id 续跑钥匙 | | friday-research | 交付上下文调研专员：跨仓检索、项目上下文召回、历史交付查询，消化原始召回结果后返回带 ID 出处的证据摘要 | 只读工具白名单；证据里没有的不写；控制返回体积 |

分发形态：包内 agents/*.md 为 canonical（Claude Code 格式，含 tools: 白名单）；装进 Cursor 时自动剥离 Claude 专属 frontmatter 键（tools / color / effort / model），工具约束由正文协议兜底。

| Agent | 项目级 | 全局 | | --- | --- | --- | | Cursor | .cursor/agents/ | ~/.cursor/agents/ | | Claude Code | .claude/agents/ | ~/.claude/agents/ |

Claude Code 插件形态经 .claude-plugin/plugin.json 的 "agents" 字段自动带上，无需单独安装。

安装

推荐顺序：先配 MCP 连接，再装 Skills。

第一步 — 配置 Friday 连接

npx -y @friday-ai-codes/mcp setup

交互式中文向导：凭证问答 → 注册进本机 agent → 连通性测速（ms 高亮）→ 能力演示。访问令牌在 Friday Web 控制台「个人资料 → 访问令牌」创建（明文只显示一次）。

第二步 — 安装 Skills（交互式向导）

npx @friday-ai-codes/skills

向导会：展示渐变 banner → 选择安装范围（当前项目 / 全局）→ 自动嗅探本机 agent（Cursor / Claude Code / Codex / Gemini CLI / OpenCode）并默认勾选 → 把 8 个技能拷进各 agent 原生技能目录、把 2 个 subagent 装进 Cursor / Claude Code 原生 agents 目录 → 检测 MCP 配置，未配置时直接接力拉起 mcp setup。

非交互（脚本 / CI）

npx @friday-ai-codes/skills install -y                          # 嗅探到的全部 agent，全局
npx @friday-ai-codes/skills install --project --agent cursor    # 当前项目，仅 Cursor
npx @friday-ai-codes/skills install --agent claude-code -g      # 全局，仅 Claude Code
npx @friday-ai-codes/skills install -y --no-bootstrap           # 只装技能，不注入指令文件
npx @friday-ai-codes/skills list                                # 列出打包技能

Claude Code — 插件形式（推荐，本地上下文回流全自动）

插件形式额外提供三样：

1. SessionStart hook：每个会话自动注入 friday 入口技能；
2. UserPromptSubmit / Stop hooks：每条消息前按当前 git 分支自动召回 Friday 项目上下文（feature list / 需求 / 记忆）注入对话，轮次结束把改动摘要静默沉淀回项目记忆——「我们开发到哪一步了」「继续开发」开箱即答；(session, branch) 级缓存防重复注入，FRIDAY_HOOKS_DISABLED=1 / FRIDAY_STOP_WRITEBACK=0 可关闭；
3. 捆绑 MCP server 声明（装插件即注册 friday MCP server）。

claude plugin add friday-ai-codes/skills

兼容社区 skills CLI

npx skills add friday-ai-codes/skills --skill '*' -g -y

注意：此路径不会引导后续配置——请务必先完成第一步（mcp setup）。

自动注入

安装器默认把一段精简的 friday 入口引导注入各 agent 的原生指令文件（marker 幂等，可用 --no-bootstrap 关闭）：

| Agent | 项目级 | 全局 | | --- | --- | --- | | Cursor | .cursor/rules/friday.mdc（alwaysApply） | ~/.cursor/rules/friday.mdc（注：文件方式偶有不生效，官方推荐 Settings → Rules） | | Claude Code | CLAUDE.md | ~/.claude/CLAUDE.md | | Codex | AGENTS.md | ~/.codex/AGENTS.md | | Gemini CLI | GEMINI.md | ~/.gemini/GEMINI.md | | OpenCode | AGENTS.md（与 Codex 共用，自动去重） | ~/.config/opencode/AGENTS.md |

项目级注入使用相对路径（文件会进 git，队友机器同样生效）。另外 Claude Code 插件形式自带 SessionStart hook，把 friday 入口技能全文注入每个会话。

本地验证

node bin/friday-ai-skills.mjs list        # 应列出 8 个技能 + 2 个 subagent
npm run pack:dry-run                       # 检查 npm tarball 内容（应含 agents/）
bash hooks/session-start | head -1         # 合法 JSON 上下文注入

发布（维护者）

npm publish --access public

License

MIT