Agent Skills
› mindfold-ai/Trellis
› trellis-spec-bootstrap
trellis-spec-bootstrap
GitHub基于真实代码库生成或刷新Trellis编码规范，通过单Agent工作流完成仓库分析、规范分解与文档编写，确保内容无占位符且贴合实际架构。
Trigger Scenarios
创建或更新.trellis/spec/规范文件
基于GitNexus等工具分析代码库并生成编码指南
Install
npx skills add mindfold-ai/Trellis --skill trellis-spec-bootstrap -g -y
SKILL.md
Frontmatter
{
"name": "trellis-spec-bootstrap",
"description": "Bootstrap project-specific Trellis coding specs with a platform-neutral single-agent workflow. Use when creating or refreshing .trellis\/spec guidelines, analyzing a codebase with GitNexus, ABCoder, or source inspection, decomposing package\/layer spec work, and writing real codebase-backed spec docs without placeholder text."
}
Trellis Spec Bootstrap
Use this skill to create or refresh .trellis/spec/ guidelines from the real codebase. One capable agent owns the full loop: analyze the repository, choose the spec boundaries, write the docs, and verify the result. The workflow does not depend on a specific host, CLI, or agent brand.
Workflow
- Confirm Trellis is initialized and inspect the current
.trellis/spec/tree. - Analyze the repository architecture with the best available tools: GitNexus, ABCoder, language tooling, and direct source reads.
- Decompose the spec work by package and layer only when that reflects the actual codebase.
- Fill or reshape the spec files with concrete patterns, file paths, examples, and anti-patterns from the project.
- Verify that the final specs are internally consistent and contain no template placeholders.
Reference Routing
| Need | Read |
|---|---|
| Repository architecture analysis | references/repository-analysis.md |
| Spec work decomposition and task planning | references/spec-task-planning.md |
| Writing high-signal Trellis spec files | references/spec-writing.md |
| GitNexus and ABCoder MCP setup | references/mcp-setup.md |
Operating Rules
- Treat templates as starting points, not contracts. Delete, rename, split, or add spec files when the repository calls for it.
- Prefer source-backed rules over generic advice. Every important recommendation should point at a real file or repeated local pattern.
- Keep execution single-owner by default. Optional helper agents are an implementation detail, not a requirement or user-visible dependency.
- Do not write platform-specific instructions unless the target project already standardizes on that platform.
- Do not leave placeholder text, empty headings, or copied boilerplate in
.trellis/spec/.
Done Criteria
.trellis/spec/describes the project as it exists now.- Each relevant package or layer has practical coding guidance with real examples.
- Non-applicable template sections are removed.
index.mdfiles match the final spec file set.- Any required setup or analysis assumptions are documented in the relevant spec or task notes.
Version History
- 0e0f1f6 Current 2026-08-20 08:08
