关于 trellis-spec-bootstarp
Trellis Spec Bootstarp 是用于从实际代码库创建或更新 .trellis/spec/ 指南的技能。它指导 Agent 分析架构、确定文档边界并核验结果,强调以代码证据为依据,而非依赖通用模板。
主要功能
- 01检查 Trellis 初始化状态和现有规范目录
- 02分析代码库架构与源码模式
- 03按实际包和层次划分规范
- 04编写包含路径、示例和反模式的指南
- 05检查规范一致性并清除占位内容
适用场景
- 01为已有代码库建立 Trellis 规范
- 02根据架构变化更新 .trellis/spec/
- 03核对规范是否反映实际代码模式
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mindfold-ai/ marketplace --skill trellis-spec-bootstarp安装后在 Claude Code 中输入/trellis-spec-bootstarp确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/mcp-setup.mdrepository-analysis.mdspec-task-planning.mdspec-writing.md详细介绍
Trellis 规范初始化
使用此技能,根据实际代码库创建或更新 .trellis/spec/ 指南。由一名能力胜任的 Agent 负责完整流程:分析代码库、确定规范边界、编写文档并验证结果。此工作流不依赖特定宿主、CLI 或 Agent 品牌。
工作流
- 确认 Trellis 已初始化,并检查当前的
.trellis/spec/目录树。 - 使用最合适的工具分析代码库架构:GitNexus、ABCoder、语言工具和直接阅读源代码。
- 仅当符合实际代码库结构时,按软件包和层级拆分规范工作。
- 根据项目中的具体模式、文件路径、示例和反模式,填充或调整规范文件。
- 验证最终规范内部一致,且不含模板占位内容。
参考资料路由
| 需求 | 阅读 |
|---|---|
| 代码库架构分析 | 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