让 Skill 跨项目生长自定义源码目录
本地迭代与 GitHub 同步

~/workspace/my-skills/                 # Git 仓库
└── skills/
    └── technical-writing/
        ├── SKILL.md                   # 必需
        ├── references/                # 可选：参考规范
        ├── scripts/                   # 可选：确定性操作
        └── assets/                    # 可选：模板与素材

~/.agents/skills/
└── technical-writing
    → ~/workspace/my-skills/skills/technical-writing

mkdir -p "$HOME/workspace/my-skills/skills/technical-writing"
git -C "$HOME/workspace/my-skills" init -b main

---
name: technical-writing
description: 将工程讨论、实现方案或排查经验整理为技术文档；用户要求写文档、写文章或沉淀实践时使用，遵循当前项目的格式与发布约定。
---

# 技术文档编写

1. 读取当前任务适用的 AGENTS.md，确认输出格式、目录、
   文章模板与目录登记要求；用户的明确要求优先。
2. 读取项目指定的规范与范例。缺少必要信息时，先检查现有
   文档结构；仍无法确定的交付位置或格式，再询问用户。
3. 区分已验证事实、方案建议和示例。涉及工具机制、版本或
   配置时核对官方资料，并给出支持关键结论的链接。
4. 按项目模板组织内容；项目未约定结构时，可采用
   “结论、背景、操作步骤、验证方式、参考资料”。
5. 检查命令、路径和示例是否前后一致，并将敏感信息替换为
   通用占位符。仅在项目要求时维护文档目录与多语言入口。
6. 核对成品结构和相关链接；有视觉要求时检查展示效果。
   报告交付文件、验证结果与仍需处理的问题。

skill_source="$HOME/workspace/my-skills/skills/technical-writing"
skill_link="$HOME/.agents/skills/technical-writing"

if [ ! -f "$skill_source/SKILL.md" ]; then
  printf '%s\n' "未找到源码中的 SKILL.md，请先完成上一步。"
elif [ -e "$skill_link" ] || [ -L "$skill_link" ]; then
  printf '%s\n' "入口已存在，请先核对它的目标："
  ls -ld "$skill_link"
else
  mkdir -p "$HOME/.agents/skills" &&
    ln -s "$skill_source" "$skill_link"
fi

readlink "$HOME/.agents/skills/technical-writing"
cat "$HOME/.agents/skills/technical-writing/SKILL.md"

$technical-writing 将刚才的工程讨论整理为文档，遵循当前项目约定。

cd "$HOME/workspace/my-skills"
git status --short
git add skills/technical-writing/SKILL.md
git diff --cached
git commit -m "feat: add reusable technical-writing skill"
git remote add origin https://github.com/YOUR_ACCOUNT/my-skills.git
git push -u origin main

mkdir -p "$HOME/workspace"
git clone https://github.com/YOUR_ACCOUNT/my-skills.git \
  "$HOME/workspace/my-skills"

git -C "$HOME/workspace/my-skills" status --short
git -C "$HOME/workspace/my-skills" pull --ff-only

cd "$HOME/workspace/my-skills"
git diff -- skills/technical-writing
git add skills/technical-writing/SKILL.md
git diff --cached
git commit -m "refactor: clarify project-specific writing rules"
git push