mcpField
T
trellis-spec-bootstarp

trellis-spec-bootstarp

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

关于 trellis-spec-bootstarp

Trellis Spec Bootstarp 是用于从实际代码库创建或更新 .trellis/spec/ 指南的技能。它指导 Agent 分析架构、确定文档边界并核验结果,强调以代码证据为依据,而非依赖通用模板。

主要功能

  1. 01检查 Trellis 初始化状态和现有规范目录
  2. 02分析代码库架构与源码模式
  3. 03按实际包和层次划分规范
  4. 04编写包含路径、示例和反模式的指南
  5. 05检查规范一致性并清除占位内容

适用场景

  1. 01为已有代码库建立 Trellis 规范
  2. 02根据架构变化更新 .trellis/spec/
  3. 03核对规范是否反映实际代码模式

安装

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

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

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

包含的文件

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

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

详细介绍

Trellis 规范初始化

使用此技能,根据实际代码库创建或更新 .trellis/spec/ 指南。由一名能力胜任的 Agent 负责完整流程:分析代码库、确定规范边界、编写文档并验证结果。此工作流不依赖特定宿主、CLI 或 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