Agent Skills
› mindfold-ai/Trellis
mindfold-ai/Trellis
GitHub提供Python CLI脚本的设计模式与原则，基于软件设计哲学，强调深度模块、类型优先和复杂度管理。用于编写、审查或重构Python代码，优化模块结构与代码质量。
Install All Skills
npx skills add mindfold-ai/Trellis --all -g -y
Skills in Collection (69)
Showing top 50 of 69 by quality score. Use the install list command or open individual skills for the rest.
提供Python CLI脚本的设计模式与原则，基于软件设计哲学，强调深度模块、类型优先和复杂度管理。用于编写、审查或重构Python代码，优化模块结构与代码质量。
编写或修改Python文件
规划模块分解结构
审查Python代码变更
重构混乱的脚本
npx skills add mindfold-ai/Trellis --skill python-design -g -y
在新编码前自动发现并注入项目特定编码规范。通过读取PRD、设计文档及Trellis规范索引，识别适用包与指南，确保开发者遵循标准后再执行任务，强制在复杂变更前界定边界。
开始新的编码任务
切换不同代码包
需要刷新项目约定和标准
npx skills add mindfold-ai/Trellis --skill trellis-before-dev -g -y
用于需求不明确或复杂任务时的协作式需求发现。通过探索代码库获取证据，引导用户确认产品意图与范围，生成PRD并收敛MVP方案，确保规划充分后再进入实现阶段。
需求描述模糊不清
存在多种可行的技术实现路径
需要开发新功能或处理复杂任务
npx skills add mindfold-ai/Trellis --skill trellis-brainstorm -g -y
用于修复bug后的深度复盘，从根因、失败原因、预防机制等维度分析，防止同类问题重复发生，并将知识沉淀到规范中。
完成Bug修复后
需要防止同类Bug再次出现时
npx skills add mindfold-ai/Trellis --skill trellis-break-loop -g -y
用于本地多智能体协作运行时，支持通过持久事件日志进行对话、派生工作进程、跨代理审查及进度调试。
和 codex/claude 讨论
brainstorm with another agent
spawn an implement/check worker
let agent review
open an issue board / changelog forum
look at this thread
channel is stuck / no output
progress was truncated
how do I write that channel command
npx skills add mindfold-ai/Trellis --skill trellis-channel -g -y
对近期代码进行综合质量验证，涵盖规范合规、Lint、类型检查、测试及跨层数据流审查，确保提交前代码一致性与安全性。
代码编写完成准备提交时
长会话中需防止上下文漂移时
npx skills add mindfold-ai/Trellis --skill trellis-check -g -y
用于恢复中断的开发任务。通过加载工作流索引和上下文，根据任务状态和产物自动判断当前所处阶段与步骤，指导开发者继续执行后续操作。
用户需要恢复之前中断的任务
用户不确定当前工作流的下一步该做什么
npx skills add mindfold-ai/Trellis --skill trellis-continue -g -y
用于结束开发会话，通过检查代码状态、归档已完成任务及记录会话日志来清理工作区。确保未提交代码不被误归档，并维护项目进度追踪。
用户表示编码工作完成准备结束会话
需要归档当前活跃任务并更新开发者日志
npx skills add mindfold-ai/Trellis --skill trellis-finish-work -g -y
用于基于真实代码库生成或刷新Trellis编码规范。通过单Agent工作流分析仓库架构，按包和层级分解任务，编写含具体示例和反模式的规范文档，确保无占位符且与实际项目一致。
创建或刷新.trellis/spec/规范
分析代码库并生成编码指南
npx skills add mindfold-ai/Trellis --skill trellis-spec-bootstrap -g -y
初始化AI开发会话，加载项目上下文、工作流指南及任务状态，根据当前阶段智能路由至脑暴、直接编辑或任务执行技能，适用于新编码、恢复工作或重建项目语境。
开始新的编码会话
恢复中断的工作
启动新任务
重新建立项目上下文
npx skills add mindfold-ai/Trellis --skill trellis-start -g -y
用于在调试、实现或讨论后捕获可执行契约和编码规范。当涉及新功能、Bug修复或设计决策时，更新.trellis/spec/下的代码规格文档，确保未来开发遵循一致的接口和验证标准。
完成功能实现后
修复Bug后
发现新的代码模式或约定后
进行架构或设计决策后
npx skills add mindfold-ai/Trellis --skill trellis-update-spec -g -y
提供GitNexus CLI工具的使用指南，涵盖代码库索引构建、状态检查、清理及文档生成等核心操作。
需要索引或重建代码库
检查索引新鲜度
清理本地索引数据
生成项目Wiki文档
npx skills add mindfold-ai/Trellis --skill gitnexus-cli -g -y
基于GitNexus工具链的调试技能，通过query、context和cypher命令追踪错误源头、调用链及执行流程，辅助定位代码缺陷与性能瓶颈。
用户询问函数失败原因
需要追踪错误来源
分析接口返回500错误
排查间歇性故障
npx skills add mindfold-ai/Trellis --skill gitnexus-debugging -g -y
用于探索和理解代码库架构、执行流程及不熟悉代码的 Skill。通过 GitNexus 工具发现仓库、查询概念相关的执行流、深入分析特定符号，并追踪完整的执行链路，帮助用户快速掌握项目结构和实现细节。
用户询问代码如何工作
需要了解系统架构
想要追踪执行流程
探索不熟悉的代码部分
npx skills add mindfold-ai/Trellis --skill gitnexus-exploring -g -y
GitNexus工具、资源及知识图谱模式的快速参考指南，提供查询代码智能、影响分析等功能的说明。
询问 GitNexus 可用工具
如何查询知识图谱
查看 MCP 资源列表
了解图模式结构
npx skills add mindfold-ai/Trellis --skill gitnexus-guide -g -y
用于代码变更前的影响分析，评估修改特定函数或模块的潜在风险。通过追踪依赖关系和受影响的执行流程，识别直接调用者及间接依赖，帮助开发者判断变更安全性并预防破坏性更新。
用户询问修改某段代码是否安全
需要分析变更的影响范围（blast radius）
提交代码前检查受影响的组件
npx skills add mindfold-ai/Trellis --skill gitnexus-impact-analysis -g -y
提供安全重构代码的指南，涵盖重命名、提取模块、拆分函数等操作。通过影响分析、上下文查询和变更检测工具，确保重构过程的安全性与准确性。
用户想要重命名函数或变量
需要提取代码到新模块
要求拆分服务或函数
移动代码到不同文件
npx skills add mindfold-ai/Trellis --skill gitnexus-refactoring -g -y
提供Python CLI脚本的设计模式与原则，基于《软件设计哲学》，强调通过深度模块和类型优先开发来管理复杂度。适用于Python文件的编写、重构、审查及模块结构规划。
编写或修改Python文件
代码审查Python变更
重构杂乱的脚本
规划模块分解
npx skills add mindfold-ai/Trellis --skill python-design -g -y
在编码前自动发现并注入项目特定的编码规范。通过读取PRD、设计文档及Trellis规范索引，确保开发者遵循项目约定与最佳实践，明确变更边界，防止偏离标准。
开始新的编码任务
切换不同包开发
需要刷新项目规范认知
npx skills add mindfold-ai/Trellis --skill trellis-before-dev -g -y
用于需求模糊时的协作式需求发现与规划。通过创建任务目录、种子PRD，逐步提问并研究技术选型，收敛MVP范围，确保在实现前明确产品意图与边界。
需求不明确需要澄清
存在多种有效实现方案
描述新功能或复杂任务
npx skills add mindfold-ai/Trellis --skill trellis-brainstorm -g -y
用于修复bug后的深度复盘，从根因、失败原因、预防机制等维度分析，旨在打破重复修Bug循环并沉淀知识。
完成Bug修复后
需要防止同类Bug再次发生
npx skills add mindfold-ai/Trellis --skill trellis-break-loop -g -y
提供多智能体协作运行时工具的使用指南，涵盖对话、工作流编排、论坛管理及调试。
多智能体讨论或头脑风暴
派生或检查子进程
查看线程上下文
排查通道卡顿
npx skills add mindfold-ai/Trellis --skill trellis-channel -g -y
用于代码提交前的综合质量验证，涵盖规范合规、Lint、类型检查、测试覆盖及跨层数据流一致性审查，确保代码变更符合预期且无上下文漂移。
代码编写完成准备提交时
需要验证近期代码质量时
长会话中检测上下文漂移时
npx skills add mindfold-ai/Trellis --skill trellis-check -g -y
用于基于真实代码库生成或刷新Trellis编码规范。通过单Agent工作流分析仓库架构、分解包层级，并编写包含具体示例和反模式的规范文档，确保内容无占位符且与实际代码一致。
创建或刷新.trellis/spec/规范文件
需要基于代码库实际结构生成编码指南
npx skills add mindfold-ai/Trellis --skill trellis-spec-bootstrap -g -y
用于在项目开发、调试或讨论后，将有价值的经验转化为可执行的代码规范文档。通过捕获API签名、契约及测试要点，确保未来AI或开发者能安全准确地执行任务。
完成功能实现后
修复Bug后
发现新设计模式时
确定技术选型或约定时
npx skills add mindfold-ai/Trellis --skill trellis-update-spec -g -y
基于上次发布以来的 Git 提交，分析并生成 Trellis 项目的版本迁移清单及文档站变更日志。涵盖补丁、Beta、RC 和次要版本的发布准备，自动提取用户可见的功能变更与修复。
准备发布新版本（patch/beta/rc/minor）
需要生成版本更新日志或迁移说明
npx skills add mindfold-ai/Trellis --skill create-manifest -g -y
在编码前发现并注入项目特定编码规范。通过读取PRD、设计文档及Treillis规范索引，确保开发者遵循项目约定和标准后再开始实现。
开始新的编码任务
切换至不同包开发
需要刷新项目规范记忆
npx skills add mindfold-ai/Trellis --skill trellis-before-dev -g -y
用于需求不明确时的协作式需求发现。通过创建任务目录、种子PRD、逐一提问及研究技术选型，收敛MVP范围，确保在实施前明确产品意图与边界。
需求描述模糊不清
存在多种有效实现方案
用户提出新功能或复杂任务
npx skills add mindfold-ai/Trellis --skill trellis-brainstorm -g -y
用于修复Bug后的深度复盘分析，通过根因分类、失败原因及预防机制等维度，将经验转化为规范文档，防止同类问题重复发生。
Bug修复完成后进行深度复盘
需要防止同类Bug重复出现时
npx skills add mindfold-ai/Trellis --skill trellis-break-loop -g -y
提供多智能体协作运行时支持，涵盖跨Agent讨论、Worker生成、论坛频道管理及进度调试。
和 codex/claude 讨论
spawn an implement/check worker
channel is stuck / no output
npx skills add mindfold-ai/Trellis --skill trellis-channel -g -y
对已编写代码进行综合质量验证，涵盖规范合规性、Lint、类型检查、测试及跨层数据流一致性，适用于提交前或长会话中防止上下文漂移。
代码编写完成需验证质量时
提交更改前检查
长会话中捕获上下文漂移
npx skills add mindfold-ai/Trellis --skill trellis-check -g -y
用于基于真实代码库生成或刷新Trellis编码规范。通过单代理工作流分析仓库架构，按包和层分解任务，编写包含具体示例和反模式的规范文档，确保无占位符且与项目现状一致。
创建或更新项目编码规范
分析代码库并生成技术文档
npx skills add mindfold-ai/Trellis --skill trellis-spec-bootstrap -g -y
用于在开发、调试或讨论后捕获可执行契约和编码规范。当涉及API变更、架构决策或修复Bug时，自动更新代码规格文档，确保知识沉淀供未来复用。
完成功能实现后
修复Bug后
发现新的设计模式或约定
npx skills add mindfold-ai/Trellis --skill trellis-update-spec -g -y
在新编码任务前自动发现并注入项目特定的编码规范。通过读取 .trellis/spec/ 下的索引、预开发清单和共享指南，确保开发者遵循标准后再开始实现。
开始新的编码任务前
切换不同包的开发环境时
需要刷新项目编码约定和标准时
npx skills add mindfold-ai/Trellis --skill trellis-before-dev -g -y
用于在编码前引导协作式需求发现，通过单轮提问、代码探索和 MVP 收敛，解决需求模糊或多路径场景。
需求不明确或正在演变时
存在多种有效实现路径时
涉及权衡决策时
npx skills add mindfold-ai/Trellis --skill trellis-brainstorm -g -y
用于修复bug后的深度复盘，从根因、失败原因、预防机制等维度分析，防止同类问题重复发生。
Bug修复完成后
需要防止同类Bug再次出现时
npx skills add mindfold-ai/Trellis --skill trellis-break-loop -g -y
用于代码提交前的全面质量验证，涵盖规范合规性、Lint、类型检查、测试及跨层数据流一致性审查。
代码编写完成需提交前
长会话中检测上下文漂移
需要执行预提交质量检查时
npx skills add mindfold-ai/Trellis --skill trellis-check -g -y
该技能用于基于真实代码库创建或更新 .trellis/spec/ 编码规范。通过单代理工作流，分析仓库架构、分解规范任务并编写含具体示例和反模式的文档，确保规范与实际代码一致且无占位符。
初始化或刷新项目编码规范
基于代码库生成结构化开发指南
npx skills add mindfold-ai/Trellis --skill trellis-spec-bootstrap -g -y
用于在开发、调试或讨论后，将有价值的经验转化为可执行的代码规范文档。涵盖功能实现、Bug修复及设计决策，确保未来AI或开发者能安全执行。
完成新功能实现后
修复Bug后发现新模式
做出关键设计决策时
发现新的编码约定或陷阱
npx skills add mindfold-ai/Trellis --skill trellis-update-spec -g -y
在编码前发现并注入项目特定的编码规范。通过读取PRD、设计文档及规格索引，执行预开发检查清单，确保开发者遵循正确的代码标准和模式后再开始实现。
开始新的编码任务前
切换到不同包时
需要刷新项目约定和标准时
npx skills add mindfold-ai/Trellis --skill trellis-before-dev -g -y
用于在需求模糊时引导协作式需求发现，通过探索代码库获取证据并逐一提问，收敛MVP范围。
需求不明确
存在多种有效方案
描述新功能或复杂任务
npx skills add mindfold-ai/Trellis --skill trellis-brainstorm -g -y
用于深度复盘已修复的Bug，从根因、失败原因、预防机制等维度分析，旨在打破“修复-遗忘-重复”循环并沉淀知识。
完成Bug修复后
需要防止同类Bug再次发生时
npx skills add mindfold-ai/Trellis --skill trellis-break-loop -g -y
用于本地多智能体协作运行时，支持对话、工作流编排、论坛频道管理及进度调试。
与AI讨论或头脑风暴
派生执行/检查代理
创建论坛或查看线程
调试卡住的通道
npx skills add mindfold-ai/Trellis --skill trellis-channel -g -y
用于代码提交前的全面质量验证，涵盖规范合规、静态检查、测试及跨层数据流审查，确保代码一致性与可维护性。
代码编写完成准备提交前
需要验证代码质量与规范合规性时
npx skills add mindfold-ai/Trellis --skill trellis-check -g -y
用于基于真实代码库生成或刷新 Trellis 编码规范。通过单 Agent 工作流分析仓库架构、分解包层级，并编写包含具体示例和反模式的规范文档，确保无占位符且与项目现状一致。
创建或刷新 .trellis/spec/ 目录下的编码规范
需要基于实际代码库结构生成具体的开发指南
npx skills add mindfold-ai/Trellis --skill trellis-spec-bootstrap -g -y
用于捕获调试、实现或讨论中的有价值经验，更新代码规范文档。在完成任务、修复Bug或发现新模式后触发，确保未来会话能安全执行。
完成功能实现后
修复Bug后
发现新的编码模式或约定后
npx skills add mindfold-ai/Trellis --skill trellis-update-spec -g -y
在编码前自动发现并注入项目特定的代码规范与指南，通过读取PRD、设计文档及Trellis规格索引，确保开发者遵循统一的编码标准和最佳实践。
开始新的编码任务前
切换不同包或模块时
需要刷新项目约定和标准时
npx skills add mindfold-ai/Trellis --skill trellis-before-dev -g -y
用于需求模糊时的协作式规划，通过创建任务目录、种子PRD及单轮高价值提问，引导用户明确范围与决策，收敛MVP方案。
需求不明确
存在多种有效技术方案
描述新功能或复杂任务
npx skills add mindfold-ai/Trellis --skill trellis-brainstorm -g -y
用于深度分析已修复Bug的根因，防止重复发生。通过五维框架（根因分类、修复失败原因、预防机制、系统扩展、知识捕获）进行复盘，将洞察固化为规范文档，打破“修复-遗忘-重演”循环。
Bug修复完成后需要深度复盘时
团队希望建立Bug预防机制以防止同类问题再次出现时
npx skills add mindfold-ai/Trellis --skill trellis-break-loop -g -y
提供多智能体协作运行时工具的使用指南，涵盖跨代理讨论、工作流编排、论坛频道管理及调试。
与 codex/claude 讨论
派一个 implement/check agent
开 issue 区 / topic 群
看看这个 thread
channel 卡住了 / 没输出
npx skills add mindfold-ai/Trellis --skill trellis-channel -g -y
