Agent Skills
› mindfold-ai/Trellis
mindfold-ai/Trellis
GitHub提供Python CLI脚本的设计模式与原则，聚焦复杂度管理、深度模块化和类型优先开发。适用于Python代码编写、重构、审查及模块结构规划，旨在提升可维护性。
安装全部 Skills
npx skills add mindfold-ai/Trellis --all -g -y
集合内 Skills (69)
按质量分展示前 50 个（共 69 个），完整列表请用安装命令预览或逐个打开详情。
提供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
用于需求模糊或复杂任务时的协作式需求发现。通过探索代码库获取证据，逐步提问以明确产品意图、范围和风险，最终收敛MVP范围并生成PRD，确保实施前规划清晰。
用户需求描述不清
存在多种可行技术方案
用户提出新功能或复杂任务
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 讨论
spawn an implement/check worker
let agent review
channel is stuck / no output
npx skills add mindfold-ai/Trellis --skill trellis-channel -g -y
用于代码提交前的全面质量验证，涵盖规范合规性、静态检查、测试覆盖及跨层数据流一致性审查，旨在捕获上下文漂移并防止过度设计。
代码编写完成需提交前
长会话中检测上下文漂移
需要综合质量验收时
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
初始化Trellis开发会话，读取项目上下文、工作流指南及任务状态。根据当前任务阶段（如规划或进行中）自动路由至相应技能（如头脑风暴或编码），用于开始新任务、恢复工作或重建项目语境。
开始新的编码会话
恢复之前的工作
启动新任务
重新建立项目上下文
npx skills add mindfold-ai/Trellis --skill trellis-start -g -y
用于捕获可执行契约和编码规范，在调试、实现或讨论后更新代码规格文档，确保未来会话能安全执行。
完成功能实现后
修复 Bug 后
发现新设计模式时
做出架构决策时
npx skills add mindfold-ai/Trellis --skill trellis-update-spec -g -y
提供GitNexus CLI工具的使用说明，涵盖代码库索引构建、状态检查、清理及文档生成等核心命令，辅助开发者高效管理项目知识图谱与上下文。
需要建立或刷新代码库索引
检查当前仓库的索引新鲜度
清理过期的索引数据
基于知识图谱生成项目文档
npx skills add mindfold-ai/Trellis --skill gitnexus-cli -g -y
用于调试代码缺陷、追踪错误来源及分析失败原因。通过query定位相关流程，context查看调用关系，结合cypher自定义追踪执行链，辅助开发者快速定位根因。
用户询问功能为何失败
需要追踪错误来源
排查500等异常响应
npx skills add mindfold-ai/Trellis --skill gitnexus-debugging -g -y
基于 GitNexus 工具探索和理解代码库架构、执行流程及函数调用关系。适用于分析陌生代码、追踪业务逻辑流或深入理解特定符号的实现细节，帮助用户快速掌握项目结构和工作机制。
询问代码如何工作
想要理解系统架构
追踪执行流程
探索不熟悉的部分
npx skills add mindfold-ai/Trellis --skill gitnexus-exploring -g -y
GitNexus工具与资源的参考指南，提供知识图谱查询、MCP资源及Schema说明。用于解答关于GitNexus功能、使用方法及底层架构的通用问题。
询问 GitNexus 可用工具
如何查询知识图谱
了解 MCP 资源
查看图 Schema
工作流参考
npx skills add mindfold-ai/Trellis --skill gitnexus-guide -g -y
用于代码变更影响分析，评估修改特定代码的风险与依赖关系。通过调用impact和detect_changes工具，识别直接及间接依赖，检查执行流程，并根据受影响范围评估风险等级，辅助安全编辑和提交前决策。
询问修改某功能是否安全
想知道修改X会导致什么破坏
需要查看代码的爆炸半径
在重大代码变更前进行安全分析
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再次出现时
npx skills add mindfold-ai/Trellis --skill trellis-break-loop -g -y
提供本地多智能体协作运行时工具的使用指南，涵盖智能体对话、工作流调度、论坛频道管理及进度调试等功能。
和 codex/claude 讨论
spawn an implement/check worker
channel is stuck / no output
brainstorm with another agent
npx skills add mindfold-ai/Trellis --skill trellis-channel -g -y
用于代码提交前的综合质量验证，涵盖规范合规性、Lint、类型检查、测试覆盖及跨层数据流一致性审查。
代码编写完成准备提交时
需要验证代码质量与规范一致性时
npx skills add mindfold-ai/Trellis --skill trellis-check -g -y
基于真实代码库生成和刷新Trellis编码规范。通过单代理工作流分析仓库架构，按包和层分解任务，编写包含具体模式和示例的规范文档，确保内容无占位符且与项目现状一致。
创建或刷新.trellis/spec/目录下的编码指南
需要基于实际代码库结构生成开发规范文档
npx skills add mindfold-ai/Trellis --skill trellis-spec-bootstrap -g -y
用于捕获调试、实现或讨论中的有价值信息，更新代码规范文档。确保记录可执行契约、签名、合同及测试要求，为未来开发提供安全指导。
完成功能实现后
修复 Bug 后
发现新设计模式时
确定新的编码约定时
npx skills add mindfold-ai/Trellis --skill trellis-update-spec -g -y
根据历史提交分析生成版本迁移清单和文档站点变更日志，适用于补丁、测试版等发布准备。
准备新版本发布
生成变更日志
npx skills add mindfold-ai/Trellis --skill create-manifest -g -y
在编码前自动发现并注入项目特定编码规范。通过读取PRD、设计及Spec索引，确保遵循约定后再实施开发，适用于新任务或切换包时刷新标准。
开始新的编码任务前
切换到不同软件包时
需要刷新项目编码规范时
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
用于本地多智能体协作运行时，支持实时对话、派生工作进程、跨代理审查、进度检查及论坛式日志调试。
与 AI 代理讨论或头脑风暴
派生实现或检查代理
代理审查任务
创建论坛或议题板
调试卡住或缺失输出的通道
npx skills add mindfold-ai/Trellis --skill trellis-channel -g -y
用于代码提交前的综合质量验证，涵盖规范合规、Lint、类型检查、测试及跨层数据流一致性审查，防止上下文漂移。
代码编写完成后需进行质量验证时
提交更改前执行预检时
长会话中需捕获上下文漂移时
npx skills add mindfold-ai/Trellis --skill trellis-check -g -y
基于真实代码库生成或刷新Trellis编码规范，通过单智能体工作流完成仓库分析、规范分解、文档编写及验证，确保规范内容具体且无占位符。
创建或更新.trellis/spec/目录下的编码规范
需要基于实际代码结构生成项目特定的开发指南
npx skills add mindfold-ai/Trellis --skill trellis-spec-bootstrap -g -y
用于在开发、调试或讨论后，将有价值的经验转化为可执行的代码规范文档。涵盖功能实现、Bug修复及设计决策，确保API签名、契约和测试用例被准确记录，以保障未来开发的正确性。
完成功能实现后
修复Bug后
发现新设计模式时
确定新的编码约定时
npx skills add mindfold-ai/Trellis --skill trellis-update-spec -g -y
在新编码任务前发现并注入项目特定的编码规范。通过读取规格索引、预开发清单和共享指南，确保开发者遵循项目的编码标准和模式，为后续实现做准备。
开始新的编码任务
切换至不同包进行开发
需要刷新项目约定和标准
npx skills add mindfold-ai/Trellis --skill trellis-before-dev -g -y
用于在开发前引导协作式需求发现。通过创建任务目录、生成PRD及逐一提问，探索技术选型并收敛MVP范围，适用于需求模糊或存在多种实现路径的场景。
需求不明确或正在演变
存在多种有效的实现路径
需要权衡UX、可靠性等技术指标
用户描述新功能或复杂任务
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
用于代码提交前的综合质量验证，涵盖规范合规、Lint、类型检查、测试及跨层数据流一致性审查。
代码编写完成需提交前
长会话中检测上下文漂移
npx skills add mindfold-ai/Trellis --skill trellis-check -g -y
用于基于真实代码库生成或刷新 Trellis 编码规范。通过单智能体工作流分析仓库架构、分解包层级，并编写含具体示例和反模式的规范文档，确保内容无占位符且与代码一致。
创建或更新 .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
在编码前自动发现并注入项目特定编码规范，通过读取PRD、设计文档及Spec索引，确保开发者遵循既定标准与检查清单。
开始新的编码任务
切换不同包开发
需要刷新项目规范
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生成、论坛渠道管理及进度调试。
与AI代理讨论或头脑风暴
生成或检查子进程Worker
查看或创建论坛/话题板
调试卡住或无输出的Channel
npx skills add mindfold-ai/Trellis --skill trellis-channel -g -y
提供全面的代码质量验证，包括规范合规性、静态检查、测试及跨层数据流审查。用于提交前或长会话中捕获上下文漂移，确保代码安全与一致性。
代码编写完成后需进行质量验证
准备提交更改前
长会话中检测上下文漂移
npx skills add mindfold-ai/Trellis --skill trellis-check -g -y
基于真实代码库生成或刷新 Trellis 编码规范，通过单代理工作流完成仓库分析、规范分解与文档编写，确保内容具体且无占位符。
创建或更新 .trellis/spec/ 目录下的编码规范
需要基于实际代码库结构生成具体的开发指南
npx skills add mindfold-ai/Trellis --skill trellis-spec-bootstrap -g -y
用于在开发、调试或讨论后，将有价值的经验、设计决策和编码约定捕获为可执行的代码规范文档。确保未来会话能安全准确地执行任务，涵盖触发场景、输出结构及规范与指南的区别。
完成功能实现后
修复Bug后
发现新模式或陷阱时
团队确立命名或架构约定时
npx skills add mindfold-ai/Trellis --skill trellis-update-spec -g -y
在编码前自动发现并注入项目特定的编码规范。通过读取PRD、设计及Spec索引，识别适用包和层级，加载预开发清单中的具体指南，确保开发者遵循标准后再执行任务。
开始新的编码任务前
切换到不同代码包时
需要刷新项目约定和标准时
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 讨论
spawn an implement/check worker
channel is stuck / no output
open an issue board
npx skills add mindfold-ai/Trellis --skill trellis-channel -g -y
