今天做了什么
- 用
$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 跟踪上游版本;若技能说明变化,再回来修订维护约定。