mcpField
T
trellis-spec-bootstrap

trellis-spec-bootstrap

github.com/mindfold-ai开发15.0k104 次安装4 周前更新
代码仓库

关于 trellis-spec-bootstrap

此 skill 根据代码库的实际代码与架构创建或更新 `.trellis/spec/` 指南,供处理代码库的 Agent 使用。它涵盖分析、文档组织、撰写和验证,默认由单一负责人完成。

主要功能

  1. 01分析代码库架构
  2. 02确定规范文档边界
  3. 03编写有源码依据的项目指南
  4. 04检查一致性并清除占位内容

适用场景

  1. 01为新初始化的 Trellis 代码库创建规范
  2. 02代码库变更后更新指南
  3. 03按软件包或层级组织文档

安装

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

$npx skills add https://github.com/mindfold-ai/trellis --skill trellis-spec-bootstrap

安装后在 Claude Code 中输入/trellis-spec-bootstrap确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
mcp-setup.md
repository-analysis.md
spec-task-planning.md
spec-writing.md

详细介绍

Trellis 规范引导

使用此技能,根据实际代码库创建或更新 .trellis/spec/ 指南。由一个具备相应能力的 Agent 负责完整流程:分析仓库、确定规范边界、编写文档并验证结果。此工作流不依赖特定的宿主、命令行工具或 Agent 品牌。

工作流

  1. 确认 Trellis 已初始化,并检查当前的 .trellis/spec/ 目录树。
  2. 使用最合适的可用工具分析仓库架构:GitNexus、ABCoder、语言工具,以及直接阅读源代码。
  3. 仅当符合实际代码库的结构时,才按包和层拆分规范工作。
  4. 根据项目中的具体模式、文件路径、示例和反模式,填写或调整规范文件。
  5. 验证最终规范内部一致,且不含模板占位内容。

参考资料路由

需求阅读
仓库架构分析references/repository-analysis.md
规范工作拆分与任务规划references/spec-task-planning.md
编写高信号的 Trellis 规范文件references/spec-writing.md
GitNexus 和 ABCoder MCP 设置references/mcp-setup.md

操作规则

  • 将模板视为起点,而非必须遵守的约定。根据仓库实际情况删除、重命名、拆分或新增规范文件。
  • 优先采用有源代码依据的规则,而非通用建议。每条重要建议都应指向真实文件或反复出现的本地模式。
  • 默认由单一负责人完成执行。可选的辅助 Agent 只是实现细节,不是必需条件或用户可见的依赖。
  • 除非目标项目已将特定平台作为标准,否则不要编写平台专属说明。
  • 不要在 .trellis/spec/ 中留下占位文本、空标题或照搬的样板内容。

完成标准

  • .trellis/spec/ 准确描述项目当前的实际情况。
  • 每个相关的包或层都有实用的编码指南,并附有真实示例。
  • 删除不适用的模板部分。
  • index.md 文件与最终规范文件集保持一致。
  • 任何必需的设置或分析假设都已记录在相关规范或任务说明中。

评论

支持 Markdown