Laviya

Laviya Agent Skills

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

软件包

• laviya-agent-skills：适用于基于 Node 的工具的可复用提示词、规则和技能资源包
• laviya-mcp-server：从 mcp/ 发布的 stdio MCP 运行时
• 远程 MCP 端点 https://api.laviya.app/api/mcp（OAuth），从 mcp-remote/server.json 注册

包含内容

• core/：共享编排提示词资源
• mcp/：TypeScript MCP 运行时脚手架（laviya-mcp-server）
• cursor/：Cursor 规则产物
• claude/：Claude 技能产物（用于编排的 SKILL.md、用于用户驱动交付周期的 laviya-delivery-cycle/SKILL.md、用于将 PRD 转化为 Laviya 工作项的 laviya-prd-intake/SKILL.md）
• docs/：设置、npm 发布和最终用户入门指南（docs/examples/：PRD 示例）

仓库结构

laviya-agent-skills/
  core/
  mcp/
    src/
    examples/
    README.md
  mcp-remote/
    server.json
  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
laviya-prd-intake（将 PRD 转化为史诗、用户故事、任务、冲刺和测试用例；PRD 示例：docs/examples/prd-order-export.md）	claude/laviya-prd-intake/SKILL.md	~/.claude/skills/laviya-prd-intake/SKILL.md	<project>/.claude/skills/laviya-prd-intake/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", "$HOME\.claude\skills\laviya-prd-intake" | 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"
Copy-Item claude\laviya-prd-intake\SKILL.md "$HOME\.claude\skills\laviya-prd-intake\SKILL.md"

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

mkdir -p ~/.claude/skills/laviya-orchestrator ~/.claude/skills/laviya-delivery-cycle ~/.claude/skills/laviya-prd-intake
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
cp claude/laviya-prd-intake/SKILL.md ~/.claude/skills/laviya-prd-intake/SKILL.md

检查：启动新的 Claude Code 会话并运行 /skills；列表中必须包含 laviya-orchestrator、laviya-delivery-cycle 和 laviya-prd-intake。更新此仓库后，请再次复制这些文件。即使不安装这些技能，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 + MCP Registry 发布指南（stdio 和远程条目、GitHub Copilot 列表）：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_list_tasks
• laviya_create_tasks
• laviya_start_delivery_run
• laviya_get_task
• laviya_upload_task_file
• laviya_update_task_description
• laviya_assign_task
• laviya_list_sprints
• laviya_create_sprint
• laviya_assign_tasks_to_sprint
• laviya_list_task_links
• laviya_add_task_link
• laviya_remove_task_link
• laviya_list_test_cases
• laviya_create_test_cases
• laviya_report_test_result
• laviya_list_wikis
• laviya_get_wiki
• laviya_create_wiki
• laviya_update_wiki
• laviya_start_task_work
• laviya_complete_task_work
• laviya_get_my_work
• laviya_start_execution
• laviya_complete_execution
• laviya_report_token_usage
• laviya_diagnostics

所有工具均以 { HasFailed, Messages, Data } 形式返回 API 信封 JSON 文本。

工作项可能包含由后端定义的 ExecutionPolicy。分析和审查策略为只读：Agent 不得实施更改，强制执行的策略要求在完成时提供真实的 executionEvidence。

如需了解完整架构详情和文件级脚手架，请参阅 mcp/README.md。