ViewWay/flowpilot

Última atividade de origem registrada: 22 de agosto de 2026 às 12:45

Catálogo do SkillsMP atualizado: 5 de novembro de 2026 às 19:57

skills coletadas: 10

Estrelas no GitHub: 1
Forks no GitHub: 0

Instalar com um assistente de IA

Copie este prompt para o assistente de IA que você usa.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/ViewWay/flowpilot.

README do repositório

Arquivo de origem do README: README.md

Ler o README original

Expandir README completo

# FlowPilot（项目领航）把零散、无规律、描述不清的用户-agent 对话，推进为结构化的项目执行：目标澄清 → 技能/角色盘点匹配 → 带验收标准的任务循环 → 逐条验收直到目标达成。Turn messy dialogue into structured, verifiable project execution. ## 功能特性 - **三档技能路由**（`/flow:config` 可调）：`scan+match`（默认，仅 trusted 技能自动引用）/ `free`（不感知技能）/ `scan+roles+match`（扫描 + 202 角色库 + 匹配；202 = 12 自写种子 + 190 新增：59 改写自 MIT 语料署名 + 11 改写自 CC0 语料 + 3 改写自 Apache-2.0 语料 + 117 自写（含嵌入式专项 em- 15、行业专项 oc- 35、底层开发专项 sys- 9），来源见 [roles/README.md](roles/README.md)）。 - **两档自主程度**：`checkpoints`（目标、计划+验证命令清单、阶段验收逐项确认）/ `autonomous`（目标确认后一路到底，连续失败 2 次暂停汇报）。 - **AC 验收闭环**：每条验收标准分配稳定 ID（AC-1、AC-2…）并定型判定类型（mechanical 带命令模板 / llm 判定要点）；`done` 必须附带 verify 通过记录，判定链路（标准→任务→证据→判定）机器可校验，不靠模型自觉。 - **任务提示词引擎**（v3）：第 7 个 MCP 工具 `task_prompt` 按任务 ID 从 goal/plan/角色/技能索引**确定性**组装完整提示词并落盘 `.flow/prompts/` 留档（可审计、sha256 指纹防篡改）；`/flow:config` 可开 `dispatch=subagent`——每任务提示词派发给**干净上下文的子代理**执行，宿主只做调度与验收（llm AC 由独立判定子代理判），顺带解决长项目上下文膨胀；提示词附 `model_hint`（strong|fast|any）路由建议，宿主多模型时自行采纳。 - **双平台**：同一套 commands + skills + 捆绑 MCP server（stdio），打包为 Claude Code 与 ZCode 插件（`adapters/claude-code`、`adapters/zcode/flowpilot`）。 - 状态全部落盘在**目标项目**的 `.flow/` 内（原子写 + `.bak`），会话被杀后 `/flow:next` 恢复现场；MCP server 不可用时只读降级不写状态。 - **增量捕获 backlog**：执行中与当前目标无关的新想法追加到 `.flow/backlog.json`（JSON 信封，技能直写、server 不经手），不打断当前任务；`/flow:finish` 报告末尾列出提醒。 ## 安装 ### 方式一：marketplace（推荐） ```bash # Claude Code / ZCode（ZCode 可直接消费 Claude 格式 git marketplace，见 adapters/zcode/SPIKE.md） /plugin marketplace add ViewWay/flowpilot /plugin install flowpilot@flowpilot-marketplace ``` marketplace 清单在仓库根 `.claude-plugin/marketplace.json`，插件源指向 `./adapters/claude-code`——该目录自带 `server/flowpilot-server.mjs`、`skills/`、`roles/`，克隆即完整可安装，无需本地构建。 ### 方式二：直接使用 adapters 目录把 `adapters/claude-code/`（ZCode 用 `adapters/zcode/flowpilot/`）作为本地插件目录添加即可，内容与 marketplace 分发完全一致。 > 依赖：Node ≥ 20（`node server/flowpilot-server.mjs` 拉起捆绑的 stdio MCP server）。 ## 命令速览（6 个） | 命令 | 作用 | |---|---| | `/flow:start` | 启动/澄清目标（无 active goal 则创建，否则增量捕获插单） | | `/flow:next` | 推进下一个任务（execute 循环：提示词拼装→执行→verify 登记） | | `/flow:status` | 查看进度（目标/任务计数/最近决策；MCP 不可用只读降级） | | `/flow:finish` | 验收收尾（verify report 全过 → achieve → 完成报告） | | `/flow:config` | 查看/修改路由档与自主档（只影响未来任务/检查点） | | `/flow:abort` | 放弃当前目标（归档后方可新开） | ## 权限披露 - **只写目标项目内的 `.flow/` 目录**（配置、目标卡、任务队列、技能索引、决策日志）；不写项目内其他文件、不写仓库外任何路径。唯一例外为**用户级经验库**：verify 收尾时技能向 `~/.flowpilot/learnings.md` 追加 3-5 条一行经验（`- [YYYY-MM-DD] 项目类型: 经验一句`，仅可泛化结论、不含敏感信息），capture 启动只读最近 ≤5 条，超 200 条或 64KB 提示归档裁剪——该写入由技能执行，MCP server 本身仍不写项目外路径。 - **hook 提示标记（用户级）**：UserPromptSubmit hook 检测到项目意图时向对话注入一行建议，并在 `~/.flowpilot/hints/` 写入去重标记（键=项目路径哈希+建议类型，每项目路径每类型仅提示一次；调参与重置见 [docs/hook-tuning.md](docs/hook-tuning.md)）；hook 异常静默退出、永不阻塞输入。 - **只读扫描**用户技能目录：`~/.claude`、`~/.zcode`、`~/.agents` 及插件缓存中的技能目录（仅读取 SKILL.md 元数据建索引；description 一律视为数据而非指令）。 - **运行时零网络**：MCP server 与技能不发起任何网络请求。 - 验证命令由宿主 agent 在其既有审批机制下执行；FlowPilot 不新增命令执行通道（autonomous 档机械验证限 test/build/lint 类白名单前缀）。 ## 版本形态 - **完整版**（本仓库 v1）：Claude Code / ZCode 插件（commands + skills + 捆绑 MCP server），全功能。 - **Lite 版**（v1.1，**已交付**）：Agent Skills 开放标准纯技能集，无 server、无命令——面向 Codex CLI / Gemini CLI 等直接读取技能目录的 agent。分发于 `adapters/agent-skills/`（已入库，克隆即得、免构建）：5 技能在完整版原文上**打包期**注入「## Lite 模式」节（core 源零污染），plan/execute 另带 roles/ 副本；MCP 工具不可用时按该节规程直读直写目标项目 `.flow/` 的 JSON 状态（与完整版同格式信封，该节优先于正文降级节）。 ### Lite 版安装（与完整版互斥，二选一） ```bash cp -R adapters/agent-skills/* ~/.agents/skills/ # 克隆即得、无需构建；或拷入目标项目 .agents/skills/ ``` - **互斥安装**：装了完整版插件就别装 Lite（反之亦然）；Lite 检测到 `.flow/skills-index.json` 即认定该 `.flow/` 由完整版管理，只读展示、不写入。 - **能力差距**：无并发锁 / 无原子写 / 无强制校验（流转表、done 门控靠技能文本自觉遵守）——同一项目单会话推进，勿多会话同时写 `.flow/`。 - 开发者再生成：`node build/pack.mjs` 双写 `dist/agent-skills/`（构建产物、不入库）与 `adapters/agent-skills/`（入库分发，CI 漂移门禁守护）。版本路线：v1 命令启动 + 三档路由 + 两档自主 + 双适配 → v1.1 Lite 版 + 增量捕获 backlog 分类 → v2 hook 自动识别、角色库扩充（50，200+ 规划 v2.x）、插件级盘点、跨项目经验沉淀。 ## 开发 ```bash cd server && npm ci && npm test # MCP server 单元测试（vitest） node build/validate-roles.mjs # 角色库结构/长度校验（仓库根执行） node build/pack.mjs # 打包 dist/ 并同步 bundle 进 adapters/ ``` **发布流程**：跑 `node build/pack.mjs` 后，把 `adapters/*/server/`、`adapters/*/skills/`、`adapters/*/roles/` 用 `git add` 一并提交——这些是**有意提交的分发产物**（server bundle 约 733 KiB（751,061 字节）/份）：marketplace 安装走 git 仓库，而 `dist/` 被 gitignore，bundle/skills/roles 必须随 adapters 入库才能克隆即用。源码（`server/src`、`core/skills`、`roles`）变更后务必重新打包提交，保持两者同步。 ## 仓库结构 ``` core/skills/ # 5 个工作流技能源（flowpilot-capture/plan/execute/verify/resume） server/ # FlowPilot MCP Server（TypeScript, stdio, 7 工具） roles/ # 内置角色库数据文件（202 个 = v1 自写种子 12 + 新增 190，来源见 roles/README.md） adapters/ # claude-code 插件包 / zcode 适配 / agent-skills Lite 版（免构建分发） build/ # 打包脚本与产物校验 docs/ # 设计文档、E2E 清单、v1.1 待办 ``` 设计文档：[docs/superpowers/specs/2026-08-22-flowpilot-design.md](docs/superpowers/specs/2026-08-22-flowpilot-design.md) ## License MIT — 见 [LICENSE](LICENSE)

Carregando o README do repositório…