mcpField
I
init-effort

init-effort

github.com/yahyabedirhan开发263 次安装1 周前更新
代码仓库

关于 init-effort

用于在新分支和工作树中启动较大型工作的技能，涵盖确定范围到启动思考会话。项目没有现有仓库时，也可创建新项目和仓库。

主要功能

  1. 01区分现有仓库与新项目
  2. 02确认工作和分支名称
  3. 03在新分支创建工作树
  4. 04编写交接文档
  5. 05启动思考会话

适用场景

  1. 01隔离规划功能或重构工作
  2. 02启动尚无仓库的项目

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/yahyabedirhan/skills --skill init-effort

安装后在 Claude Code 中输入/init-effort确认已加载。

附带文件agents/openai.yamlproject-creation.md

详细介绍

初始化工作事项

工作事项是规模足够大、需要创建独立分支和拉取请求的工作：功能、新应用、重构或重新架构。日常维护工作（例如数据编辑和小型修复）无需使用此技能，可直接在当前检出版本中完成；项目可能会在相应位置列出哪些工作属于日常维护。

此技能创建的工作树将用于工作事项的思考阶段和后续构建阶段。只能写入该工作树；如果是新项目，则只能写入新仓库，以确保启动本次会话时所在的仓库保持原样。

参数

  • <worktree-tool>：用于创建和释放工作树的工具，例如 treehouse 或原生 Git 工作树。
  • <session-host>：运行 Agent 会话的位置，例如 herdr、Claude Code Desktop、Codex Desktop。
  • <agent>：启动新 Agent 会话的命令，例如 claude 或 codex，以及相应的标志。

步骤

  1. 确定项目位置： 工作事项属于现有仓库（即当前仓库或创意指定的仓库），还是尚无仓库的新项目。
  2. 命名。 提议一个简短的 kebab-case 工作事项名称，以及一个符合项目分支命名规则的分支名；如果项目没有命名规则，则使用 <area>/<effort>。请维护者确认两者。
    • 对于新项目： 先提议几个项目名称，并确认其中一个。
  3. 仅限新项目，创建项目。 询问使用哪种许可证，并建议使用以维护者名义发布的 MIT 许可证。还要询问 GitHub 仓库应为公开还是私有。然后阅读 project-creation.md，并创建和推送仓库。
  4. 使用 <worktree-tool>，从远程默认分支在新分支上创建工作树。
    • 如果工作事项基于本地默认分支上尚未推送的提交，则改为从本地分支创建。
  5. 将创意写入交接文档，路径为 <handoff-folder>/<date>-<effort>.md，其中 <handoff-folder> 按 handoff 技能中的定义设置。文档需包含维护者提供的创意、工作事项、分支和工作树。
    • 对于新项目： 还需包含其仓库。
  6. 启动思考会话： 通过 <session-host> 在工作树中启动 <agent>，并传入工作树、将工作事项作为主题、将 thinking 作为角色，以及下方的启动提示词。
    • 如果会话在其他位置运行： 告知维护者会话位置；等到 <session-host> 报告已开始处理该提示词，或维护者表示已启动后，即可停止。

启动提示词为一行，因为多行提示词会作为粘贴文本传入，导致其技能无法启动：

Think through the effort in <handoff path>: grill me on it with the grilling skill, using the prototype skill when a question needs a runnable answer, then write the spec with to-spec and the tickets with to-tickets, and hand over to an orchestrator with the handover skill.

此提示词仅包含 Agent 可以加载的技能。

参考资料

评论

支持 Markdown