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