关于 trellis-spec-bootstrap
此 skill 根据代码库的实际代码与架构创建或更新 `.trellis/spec/` 指南,供处理代码库的 Agent 使用。它涵盖分析、文档组织、撰写和验证,默认由单一负责人完成。
主要功能
- 01分析代码库架构
- 02确定规范文档边界
- 03编写有源码依据的项目指南
- 04检查一致性并清除占位内容
适用场景
- 01为新初始化的 Trellis 代码库创建规范
- 02代码库变更后更新指南
- 03按软件包或层级组织文档
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ mindfold-ai/ trellis --skill trellis-spec-bootstrap安装后在 Claude Code 中输入/trellis-spec-bootstrap确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/mcp-setup.mdrepository-analysis.mdspec-task-planning.mdspec-writing.md详细介绍
Trellis 规范引导
使用此技能,根据实际代码库创建或更新 .trellis/spec/ 指南。由一个具备相应能力的 Agent 负责完整流程:分析仓库、确定规范边界、编写文档并验证结果。此工作流不依赖特定的宿主、命令行工具或 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