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.
Who sent you here
- The
learningstep of ateamai-share-learningsrun (its brief names this skill): work steps 1–3 of How It Works with the person, in this session rather than a sub-agent. The session may have taught more than one thing: write each learning the person wants to share to its own document outside the repository, and return them as the list the brief asks for, each with its path, title and learnings namespace; return an empty list when nothing is worth sharing. Do not runteamai contribute: the run'scontributestep runs it for each one after its approval. For a session other than your own, read it withteamai session show <session> --source <source>. - The friction reminder (its text,
[teamai]or the team's own, namesteamai skill get share): teamai already found thatteamai-share-learningscannot run here. Follow How It Works to the end. - The person asked to share what this session taught, or to close it: start the
teamai-share-learningsworkflow (to only publish or score it,teamai-share-session). Runteamai workflow start --describe teamai-share-learnings --driver skill, give the person each proposed input with itswhy, and start it with those values once they confirm or change them (teamai skill get workflowcovers the run). Itslearningstep brings you back here. When describe refuses it (invoke_denied,unattended_denied,nested_workflow), tell the person why and follow How It Works to the end. - Anything else in When to Use: follow How It Works to the end.
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
- When
teamai scoreprinted a label that did not pass: read the reasoning file it names (<dataHome>/scores/reasoning/<labelVersion>.md) and turn what went wrong into a learning, contributed with the--session-idthat line gives, if any. Summarize it; do not paste the file
How It Works
- Summarize: review the tools used, the problems solved and the patterns found in this session
- 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
- Save it: write the document to a temporary file
- 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
- Outside a
teamai-share-learningsrun, 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-learningsbranch, underlearnings/, 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.