laviya-agent-skills

Laviya Agent Skills

Laviya Agent Skills 是一个用于 IDE 和 Agent 集成的可复用编排资源仓库。 它提供面向生产环境的 MCP 运行时、共享编排提示词资源，以及适用于 Cursor 和 Claude 等工具的专属资源。

软件包

• laviya-agent-skills：面向基于 Node 的工具的可复用提示词、规则和技能资源包
• laviya-mcp-server：从 mcp/ 发布的 stdio MCP 运行时

包含内容

• core/：共享编排提示词资源
• mcp/：TypeScript MCP 运行时脚手架（laviya-mcp-server）
• cursor/：Cursor 规则资源
• claude/：Claude 技能资源（用于编排的 SKILL.md，以及用于用户驱动交付周期的 laviya-delivery-cycle/SKILL.md）
• docs/：设置、npm 发布和终端用户入门指南

仓库结构

laviya-agent-skills/
  core/
  mcp/
    src/
    examples/
    README.md
  cursor/
  claude/
  docs/
    Setup.md
    MCPServerPublish.md
    InstallationAndUsage.md

快速开始

cd mcp
npm install
npm run typecheck
npm run build
npm run dev

必需的环境变量：

• LAVIYA_API_KEY

安装 Claude Code 技能

Claude Code 只会从 skills 文件夹加载技能。每项技能各有一个以技能名称命名的文件夹，文件名为 SKILL.md：

技能	此仓库中的源文件	安装到（个人使用，适用于所有项目）	或（仅用于一个项目）
laviya-orchestrator（编排运行）	mcp/examples/claude/SKILL.md	~/.claude/skills/laviya-orchestrator/SKILL.md	<project>/.claude/skills/laviya-orchestrator/SKILL.md
laviya-delivery-cycle（验证工作列表、创建任务、报告 Ready for deploy）	claude/laviya-delivery-cycle/SKILL.md	~/.claude/skills/laviya-delivery-cycle/SKILL.md	<project>/.claude/skills/laviya-delivery-cycle/SKILL.md

第二列中的路径是文件在此仓库中的位置，并非 Claude Code 查找文件的位置。~/.claude/laviya-delivery-cycle/ 中的文件（不在 skills 目录下）或直接放在 ~/.claude/ 中的文件都会被忽略。

Windows（PowerShell，从仓库根目录运行）：

New-Item -ItemType Directory -Force "$HOME\.claude\skills\laviya-orchestrator", "$HOME\.claude\skills\laviya-delivery-cycle" | Out-Null
Copy-Item mcp\examples\claude\SKILL.md "$HOME\.claude\skills\laviya-orchestrator\SKILL.md"
Copy-Item claude\laviya-delivery-cycle\SKILL.md "$HOME\.claude\skills\laviya-delivery-cycle\SKILL.md"

macOS / Linux（从仓库根目录运行）：

mkdir -p ~/.claude/skills/laviya-orchestrator ~/.claude/skills/laviya-delivery-cycle
cp mcp/examples/claude/SKILL.md ~/.claude/skills/laviya-orchestrator/SKILL.md
cp claude/laviya-delivery-cycle/SKILL.md ~/.claude/skills/laviya-delivery-cycle/SKILL.md

检查：启动新的 Claude Code 会话并运行 /skills；列表中必须包含 laviya-orchestrator 和 laviya-delivery-cycle。更新此仓库后，请重新复制这些文件。即使不安装技能，Laviya MCP 工具也能正常使用；技能会补充逐步执行规则。

可安装的资源包

安装可复用资源包：

npm install laviya-agent-skills

用法示例：

import { assets, resolveAssetPath } from "laviya-agent-skills";
import { readFileSync } from "node:fs";

const cursorRule = readFileSync(assets.cursorRule, "utf8");
const orchestratorPrompt = readFileSync(resolveAssetPath("orchestratorSystemPrompt"), "utf8");

文档索引

• 运行时架构和实现：mcp/README.md
• 开发者设置指南：docs/Setup.md
• NPM 发布指南：docs/MCPServerPublish.md
• 终端用户安装和使用指南：docs/InstallationAndUsage.md
• 特定客户端的 MCP 设置（Codex、VS Code、Antigravity、Claude）：docs/InstallationAndUsage.md

运行时概览

MCP 运行时采用全局运行时加项目本地配置的模式：

• 机器级运行时安装
• 仓库级项目配置（.laviya/project.json 或 .laviya.json）
• 由运行时强制执行的生命周期机制（验证、重试、幂等性和结构化日志记录）

当前 MCP 工具集包含编排流程和本地直连任务提交流程：

• laviya_help
• laviya_feed_task
• laviya_get_local_work_status
• laviya_cancel_local_work
• laviya_add_task_comment
• laviya_list_projects
• laviya_create_tasks
• laviya_start_delivery_run
• laviya_get_task
• laviya_upload_task_file
• laviya_update_task_description
• laviya_assign_task
• laviya_start_task_work
• laviya_complete_task_work
• laviya_get_my_work
• laviya_start_execution
• laviya_complete_execution
• laviya_report_token_usage
• laviya_diagnostics

所有工具都会返回 API 信封格式的 JSON 文本，结构为：{ HasFailed, Messages, Data }。

工作项可能包含由后端定义的 ExecutionPolicy。分析和审查策略为只读：Agent 不得实现更改；对于强制执行的策略，必须如实填写完成时的 executionEvidence。

完整的架构详情和文件级脚手架请参阅 mcp/README.md。