精化倡议

📌 Skill 基础信息

• Skill 名称：refine-initiative
• 来源：社区第三方（ColorMath）
• 运行宿主：仅可在支持 skills CLI 工具的 Agent 环境中运行（如配置了 skills 命令的 Claude-Code CLI 或兼容 Shell 环境）
• 核心定位：将模糊的“计划提案”（initiative）转化为团队可直接实施的具体方案，涵盖背景调研、架构分析、需求访谈和方案重写，适用于项目启动前的范围界定和方案设计阶段。

---

🧩 内部核心组成

子Agent集合

【无公开信息】

斜杠命令

命令名	功能简述
refine-initiative	对指定计划提案进行完整调研、访谈和重写，输出可执行的方案文档

MCP 工具调用

工具名称	功能简述
mcp__abacus__get_ticket	获取提案详情（含子任务）
mcp__abacus__update_ticket	更新提案描述字段
mcp__abacus__add_comment	添加评论记录决策过程
mcp__abacus__add_feature	添加新功能特性条目
mcp__abacus__update_feature	更新现有特性描述
mcp__abacus__move_feature	调整特性列表顺序
mcp__abacus__list_boards	列出看板
mcp__abacus__list_tickets	列出门票（任务）

系统工具

• Bash：执行 Shell 命令
• Read：读取文件
• Grep：文本搜索
• Glob：文件匹配
• AskUserQuestion：交互式用户提问

Hooks钩子

【无公开信息】

目录结构

【无公开信息】

---

🛠 安装与启用方式

1. 安装命令：

```bash

skills install --user ColorMath/ci

```

1. 前置依赖：

- 需已安装 skills CLI 工具

- 需配置 MCP 服务器（如 Abacus）并授权对应工具调用权限

1. 启动方式：

- 在支持 skills 的环境中直接调用：/refine-initiative [提案KEY或标题]

---

📋 标准工作流

1. 读取提案：通过 MCP 工具获取提案详情，校验类型是否为 initiative 且状态为可编辑（非 building 状态）。
2. 架构调研：深入代码库，检查现有架构（如 ADR 文档、模块结构、数据模型），识别冲突点、依赖关系和实现约束。
3. 用户访谈：基于调研结果发起多轮针对性提问（每轮≤4问题），明确需求背景、范围边界和关键决策。
4. 方案起草：重写提案描述和特性列表，包含问题定义、落地模块、决策记录、约束条件和开放问题，保持设计层级（不涉及代码细节）。
5. 确认与回写：向用户展示完整草案，确认后按顺序更新提案描述、特性内容和排序，最后添加决策注释。

---

⚠️ 关键限制、缺陷、注意事项

• 平台依赖：必须搭配 MCP 服务器（如 Abacus）使用，无法独立运行。
• Token 消耗：涉及大量代码库读取和长文本生成，Token 消耗较高，建议控制单次处理提案数量。
• 适用项目：中大型项目且有明确架构规范和文档体系（如存在 ADR、模块化代码）。
• 不适用场景：

- 纯绿地开发（无现有架构约束）

- 代码级设计（应使用 refine-ticket）

- 提案已锁定（building 状态不可修改特性）

• 生产环境：可用于方案设计阶段，但需人工复核输出；不可直接用于生产代码生成。
• 已知坑点：

- 无法通过 MCP 删除特性条目，需人工在 UI 操作；

- 提案状态校验不严格可能导致写入失败；

- 访谈环节需人工介入，无法全自动闭环。

---

✅ 适用场景 & ❌ 不适合场景

✅ 适用场景

• 团队需要将模糊需求转化为可执行方案时；
• 现有系统扩展新功能，需明确架构约束和影响时；
• 项目启动前需进行范围界定和方案评审时；
• 产品经理或架构师需要辅助撰写技术方案文档。

❌ 不适合场景

• 个人项目或快速原型开发（过度设计）；
• 代码级详细设计（应使用 refine-ticket）；
• 提案已进入开发阶段（状态为 building）；
• 无现有代码库或架构规范的全新项目。

skills install --user ColorMath/ci