build-pluginlisted
Install: claude install-skill koco-co/build-goals
# Outcome
将明确的插件需求转化为结构清晰、权限可控、能够安装和验证,并适配 Claude Code、Codex 等 Agent 的完整 Plugin。
## Routing
- 从零构建 Plugin 时,执行“新建 Plugin”分支。
- 用户提供已有 Plugin 并要求完善、修复或升级时,执行“审查与升级”分支。
- 用户要求把现有 Skills、Hooks、Agents 或配置仓库改造成 Plugin 时,执行“仓库迁移”分支。
- 用户要求同时支持 Claude Code 与 Codex 时,执行“双平台 Plugin”分支,核心组件只维护一份,Manifest 与平台适配分别管理。
- 由 `vibe-coding` 等上层总控受控调用时,保留尚未完成的内容确认,但按上层任务、提交与恢复契约返回结果。
- Plugin 需要新建或升级 Skill 时,转交 `build-skill`;平台不支持 Skill 间受控委派时,生成完整交接提示,由用户继续调用对应 Skill。
- 用户只要求编写单个 Skill 且没有插件打包、安装或分发需求时,转交 `build-skill`。
## Steps
1. 查明事实
- 完整读取 `workflows/§01-research.md`。
- 识别目标平台、现有仓库、组件、安装方式、权限、发布方式和稳定接口。
- 对已有 Plugin 或迁移任务,读取全部 Manifest、Skills、Agents、Hooks、MCP、UI、脚本、测试和发布配置。
- 核对 Claude Code 与 Codex 当前官方契约;当前范围外的平台只记录,不提前实现。
- 不询问能够从仓库、环境或文档中自行查明的事实。
- 完成条件:形成当前结构、目标结构、平台差异、风险和未知项摘要。
2. 确认关键决策
- 完整读取 `workflows/§02-clarification.md`。
- 只询问无法自行确定,并且会改变插件形态、权限、发布或验收结果的问题。
- 每轮只询问一个主要问题,同时给出推荐答案、理由和其他选择的影响。
- 已经明确的内容不得重复询问;没有待确认事项时直接进入设计。
- 完成条件:目标平台、插件形态、组件范围、安装方式、权限、版本策略和验收标准明确。
3. 提出设计并等待确认
- 完整读取 `workflows/§03-design.md`。
- 设计前读取 `rules/plugin-architecture.md`、`rules/platform-compatibility.md`、`rules/security-and-permissions.md`。
- Plugin 包含 Skill 时,同时读取 `rules/skill-architecture.md`、`rules/skill-frontmatter.md` 和 `rules/skill-quality-standard.md`。
- 使用 `templates/plugin-design-proposal.template.md` 输出 `tree` 风格目录、组件边界、平台适配、共享文件、验证和交付方案。
- 明确哪些能力属于 Skill、Agent、Hook、MCP、UI、CLI、CI 或 Manifest。
- 用户确认前不得创建、修改、移动或删除目标文件。
- 完成条件:用户明确确