根 README 编写

今天做了什么

  • $find-skills 检索 README 编写技能,对比 create-readme/readme-blueprint-generator/indexion-readme/crafting-effective-readmes 后选中后者。
  • 核验来源:softaworks/agent-toolkit(2266 stars、3.9K installs、Gen Safe/Low Risk),全局安装到 ~/.agents/skills/crafting-effective-readmes
  • 按技能流程确认项目类型为 personal,用 templates/personal.md + make-a-readme 参考扩展为全面 README。
  • README 覆盖:项目定位、核心亮点、目录结构、技术栈、快速开始、内容与发布、数据工作流、记忆库协议、当前进度、路线图、维护约定。
  • 同步登记 registry 新条目与 skillUsage;更新 demoSpace 项目笔记与 INDEX。

过程与坑

  • 沙箱内 pnpm dlx 无法访问用户目录,技能搜索/安装需要放行联网与用户级写入。
  • create-readme 安装量最高但只有通用生成指令;本仓库要求“随进度更新”,因此选了带 Creating/Updating/Reviewing 流程与模板的 crafting-effective-readmes
  • PromptScript 目标不支持全局安装,报“Failed to install 1”,但 Codex 目标已成功复制到 ~/.agents/skills,不影响使用。

下一步

  • 后续里程碑落地时,按维护约定同步更新 README 的“当前进度”与“最后更新”。
  • 可继续用 skills update 跟踪上游版本;若技能说明变化,再回来修订维护约定。