mcpField
S
skill-forge-plan

skill-forge-plan

github.com/agricidanielAgent 工作流18637 次安装29 周前更新
代码仓库

关于 skill-forge-plan

根据领域和用例设计 skill 架构的规划技能。它引导需求梳理、复杂度评估，并规划工作流、子技能、脚本和参考资料结构。

主要功能

  1. 01梳理领域与目标用户
  2. 02拆解使用场景
  3. 03评估复杂度层级
  4. 04设计架构与子技能
  5. 05规划路由与参考资料

适用场景

  1. 01根据初步需求规划 skill
  2. 02选择合适的架构层级
  3. 03定义子技能和命令路由

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/agricidaniel/skill-forge --skill skill-forge-plan

安装后在 Claude Code 中输入/skill-forge-plan确认已加载。

详细介绍

技能架构与设计规划

流程

步骤 1：领域探索

向用户提出以下问题（根据上下文调整）：

  1. 这项技能面向什么领域？（例如，SEO、广告、DevOps、数据分析）
  2. **最重要的 2-3 个使用场景是什么？**用户应能完成哪些任务？
  3. **用户会说哪些触发短语？**列出 5-10 个自然语言触发短语。
  4. **是否需要外部工具？**MCP 服务、API、命令行工具？
  5. **目标用户是谁？**开发者、营销人员、分析师、普通用户？
步骤 2：使用场景拆解

针对每个使用场景，定义：

Use Case: [Name]
Trigger: User says "[phrases]"
Steps:
1. [First action]
2. [Decision point or validation]
3. [Next action]
Result: [What success looks like]
Tools Needed: [built-in, MCP, scripts]
步骤 3：复杂度等级评估

根据回答进行评估：

信号等级 1等级 2等级 3等级 4
使用场景1-22-34-88+
需要脚本？否是可能是
需要子技能？否否是是
并行执行？否否否是
参考文档？否可能是是
行业模板？否否可能是

决策矩阵：

  • 单一工作流，无需脚本 -> 等级 1（精简）
  • 需要确定性验证 -> 等级 2（工作流）
  • 多个不同的工作流 -> 等级 3（多技能）
  • 复杂领域，需要并行委派 -> 等级 4（生态系统）
步骤 4：架构设计

根据等级生成架构：

等级 1 输出：

skill-name/
  SKILL.md

等级 2 输出：

skill-name/
  SKILL.md
  scripts/
    validate.py
    process.py
  references/
    domain-knowledge.md

等级 3 输出：

skill-name/              # Main orchestrator
  SKILL.md
  references/
    shared-reference.md
skills/
  skill-name-sub1/
    SKILL.md
  skill-name-sub2/
    SKILL.md

等级 4 输出：

skill-name/              # Main orchestrator
  SKILL.md
  references/
    ref1.md
    ref2.md
  scripts/
    script1.py
    script2.py
  assets/
    template1.md
    template2.md
skills/
  skill-name-sub1/
    SKILL.md
  skill-name-sub2/
    SKILL.md
  ...
agents/
  skill-name-role1.md
  skill-name-role2.md
步骤 5：子技能拆解（仅限等级 3-4）

针对每个子技能，定义：

  • 名称：{parent}-{function}（kebab-case）
  • 职责：单一、明确的目的
  • 输入：它需要从编排器获取什么
  • 输出：它会返回什么
  • 交叉引用：它需要的其他子技能或参考资料
  • 自包含？：它能独立运行，还是需要编排？
步骤 6：路由表

设计命令路由：

| Command | Routes to | Purpose |
|---------|-----------|---------|
| /skill-name | main SKILL.md | Interactive mode |
| /skill-name sub1 | skills/skill-name-sub1/ | Sub-workflow 1 |
| /skill-name sub2 | skills/skill-name-sub2/ | Sub-workflow 2 |
步骤 7：参考文件规划

确定应提取到参考文件中的知识：

  • 特定领域的规则和阈值
  • 行业模板
  • API 文档
  • 质量门槛和验证标准

经验法则：如果信息超过 50 行，且仅用于特定子工作流， 则将其提取到 references/。

步骤 8：生成规划文档

创建结构化的规划文档：

# Skill Plan: [name]

## Overview
- Domain: [domain]
- Tier: [1-4]
- Sub-skills: [count]
- Scripts: [count]

## Use Cases
[list from Step 2]

## Architecture
[diagram from Step 4]

## Sub-Skills
[details from Step 5]

## Routing
[table from Step 6]

## Reference Files
[list from Step 7]

## Next Steps
Run `/skill-forge build [name]` to scaffold the skill.

示例

示例：规划 DevOps 技能

用户：“我想创建一项用于管理 Docker 容器和 Kubernetes 部署的技能。”

探索结果：

  • 6 个使用场景（容器管理、K8s 部署、监控、日志、扩缩容、故障排查）
  • 需要用于运行 kubectl 和 docker 命令的脚本
  • 多个不同的工作流
  • 监控与故障排查之间存在交叉引用

评估：等级 3（多技能编排器）

架构：

devops/                     # Main orchestrator
  SKILL.md
  scripts/
    health_check.py         # Cluster health check
    log_parser.py           # Log analysis
  references/
    k8s-patterns.md         # Deployment patterns
    docker-best-practices.md
skills/
  devops-docker/SKILL.md  # Container management
  devops-k8s/SKILL.md     # Kubernetes deployments
  devops-monitor/SKILL.md # Monitoring and alerts
  devops-logs/SKILL.md    # Log analysis
  devops-scale/SKILL.md   # Scaling strategies
  devops-fix/SKILL.md     # Troubleshooting

评论

支持 Markdown