Contribute — share what a session taught you with the team

Summarize what this AI coding session taught you and push it to the team knowledge base.

Write the document in Simplified Chinese, as earlier releases required. Commands, flags, URLs, paths and code identifiers stay as they are.

When to Use

• When teamai suggests this session has valuable content worth sharing
• When you've solved a tricky problem and want to document the solution
• When you've discovered a useful workflow or pattern
• After a long session with diverse tool usage

How It Works

1. Summarize: review the tools used, the problems solved and the patterns found in this session
2. Write the document: a Markdown document (language as above) covering:
   • What the task or problem was
   • The key decisions and why they were made
   • The solution, workaround or pattern discovered
   • Which tools or skills proved especially useful
   • Pitfalls and things to watch out for
3. Save it: write the document to a temporary file
4. Push it to the team: run teamai contribute --file <path> --title "<title>"

Document Template

Copy the template, the frontmatter field table and the tag taxonomy from {SKILL_DIR}/references/doc-template.md. The frontmatter is required: it is what makes the document searchable.

Example

# After writing the summary to /tmp/session-summary.md
teamai contribute --file /tmp/session-summary.md --title "Debugging K8s pod startup timeouts"

Important

• Run this as a sub-agent (Agent tool) to avoid polluting the main session's context
• The document is pushed to the team repo's teamai-learnings branch, under learnings/, with no pull request
• Team members will see it on their next teamai pull
• Keep summaries concise and actionable — this is a knowledge base, not a diary

Publishing a reusable skill instead

A member asking to publish a skill ("share this xxx skill with my team") is a different flow, and it does not need recall: it lives in the core skill, at "$(teamai skill path core)/references/contribute-member.md". This file is for turning a session into a learning.

References

In the files below, {SKILL_DIR} is the directory teamai skill path share prints; a reference file you open on its own writes that directory as SKILL_DIR in braces.

File	When to load it
{SKILL_DIR}/references/doc-template.md	Writing the learning document: template, frontmatter fields, tag taxonomy.

teamai skill get share --full prints this skill with its reference appended.