build-skilllisted
Install: claude install-skill koco-co/build-goals
# Outcome
把明确的 Skill 需求转化为结构精简、行为可靠、能够实际运行和验证,并适配目标 Agent 平台的完整实现。
## Routing
- 新建通用 Skill 时,执行“通用 Skill”分支。
- 为指定项目创建 Skill 时,执行“项目级定制 Skill”分支,先了解项目再设计接入方式。
- 修改已有 Skill 时,执行“审查与升级”分支,先记录当前行为再提出改进方案��
- 由 `vibe-coding`、`build-plugin` 等上层总控受控调用时,保留尚未完成的内容确认,但按上层任务、提交与恢复契约返回结果。
- 用户要求构建、打包、安装、迁移或发布 Plugin 时,转交 `build-plugin`;本 Skill 只处理其中需要新建或升级的 Skill。
- 用户只要求润色提示词、编写普通文档或处理与 Skill 无关的任务时,不进入本 Skill。
## Steps
1. 查明事实
- 完整读取 `workflows/§01-research.md`。
- 读取用户已提供的需求、目标 Skill、目标仓库、现有规则和可用工具。
- 对项目级 Skill,探索项目架构、CLI、测试、Hooks、文档和既有约定。
- 对已有 Skill,记录当前输入、输出、行为、依赖、已知问题和兼容接口。
- 调研目标平台规范以及同类实现;用户明确免除外部竞品调���时,仍需核对目标环境和平台契约。
- 不向用户询问能够从环境、代码或文档中自行查明的事实。
- 完成条件:形成现状与约束摘要,清楚区分已确认事实、合理推断和未知项。
2. 确认关键决策
- 完整读取 `workflows/§02-clarification.md`。
- 只询问无法从环境确定,并且不同答案会改变结构、行为或验收结果的决策。
- 每轮只询问一个主要问题,同时给出推荐答案、推荐理由及其他选择的影响。
- 已在提示词、代码、文档或此前回答中明确的内容不得重复询问。
- 不存在真实未决问题时,明确记录“无待确认决策”,直接进入设计。
- 对已有 Skill 也要重新判断可选 Frontmatter,不因原文件只有 `name` 和 `description` 而跳过。
- 完成条件:目标、非目标、Skill 类型、触发方式、输入、输出、分支、权限边界、Frontmatter 决策和验收标准均已明确。
3. 提出设计并等待确认
- 完整读取 `workflows/§03-design.md`。
- 设计前读取 `rules/architecture.md`、`rules/frontmatter.md`、`rules/quality-standard.md` 和 `rules/platform-compatibility.md`。
- 使用 `templates/design-proposal.template.md` 组织方案;需要参考粒度时,按 Skill 类型读取对应示例。
- 输出 `tree` 风格目录、文件职责、按需读取关系、Frontmatter 字段决策矩阵、静态校验、内容审查、文案审查、平台适配和 Hooks/CLI 归属建议。
- 设计必须解释为何保留每个目录;不为形式完整创建空目录或占位文件。
- 设计完成后只请求一次实施确认。用户确认前不得创建、修改、移动或删除目标文件。
- 完成条件:用