mcpField
P
parent-project-skills

parent-project-skills

github.com/cloudflareAgent 工作流9.1k50 次安装今天更新
代码仓库

关于 parent-project-skills

面向 workerd 的技能，用于在任务超出 workerd 范围时查找和使用上级项目的上下文，并规定不得将上级项目的专有信息写入 workerd 的公开内容。

主要功能

  1. 01检测上级项目根目录
  2. 02查找上级项目技能与指南
  3. 03直接读取相关技能文件
  4. 04执行单向信息边界规则

适用场景

  1. 01调查涉及 workerd 的生产问题
  2. 02在上级项目中编写集成测试
  3. 03调试跨越 workerd 边界的问题

安装

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

$npx skills add https://github.com/cloudflare/workerd --skill parent-project-skills

安装后在 Claude Code 中输入/parent-project-skills确认已加载。

详细介绍

父项目技能发现

本项目（workerd）可能会作为子模块嵌入更大的项目中。如果任务需要了解 workerd 之外的上下文（例如调查生产问题、编写集成测试或了解部署架构），请检查父项目中是否有额外的技能和上下文。

发现流程

  1. 检查 workerd 目录上方是否存在 Git 根目录，以确定是否有父项目：

    • 相对于 workerd 根目录，查找 ../../.git 或 ../../AGENTS.md
    • 如果找到，父项目根目录就是 ../../（从 workerd 向上两级）

  2. 检查父项目技能：

    • 查找 ../../.opencode/skills/*/SKILL.md
    • 阅读任何 ../../AGENTS.md，以获取项目范围的上下文

  3. 阅读 SKILL.md 文件，加载相关技能。这些技能未在 skill 工具中注册；请使用 Read 工具直接读取。

  4. 检查子模块特定的上下文：

    • 查找可能专门提及 workerd 的 ../../.opencode/skills/*/SKILL.md 文件
信息边界——至关重要

workerd 是一个开源项目。父项目通常是专有或内部项目。

必须严格遵守单向信息边界：

  • 允许：内部上下文可用于辅助推理、帮助理解代码路径并指导调查
  • 禁止：将内部细节写入 workerd 文件，包括：
    • 提及内部系统、服务或架构的代码注释
    • 提及内部项目、Sentry 问题、Jira 工单或内部 URL 的提交消息
    • 包含内部上下文的 PR 描述或 GitHub 问题评论
    • 包含内部知识的 AGENTS.md、AGENTS.md 或文档更新
    • 会泄露内部细节的变量名、错误消息或日志字符串
    • 体现内部架构假设的测试文件

跨越边界开展工作时，workerd 一侧的产物必须仅围绕 workerd 自身的公开概念来表述（Workers、Durable Objects、isolates、IoContext 等），不得提及父项目如何对其进行编排。

何时使用此技能
  • 调查涉及 workerd 代码的生产 Sentry 问题
  • 在父项目中编写集成测试（例如 ew-test）
  • 了解 workerd API 在生产部署环境中的行为
  • 调试跨越 workerd 与父项目边界的问题
  • 审查同时影响两个项目的代码更改
  • 规划需要与父项目协调的新功能开发

评论

支持 Markdown