code-pipeline-skill
starsforks
How to install code-pipeline-skill?
yunzeforbetter/castflow/code-pipeline-skill
$npx -y skills add yunzeforbetter/CastFlow --skill code-pipeline-skillcode_pipeline code-pipeline 功能开发流程编排 Step1需求拆分 Step2约束冻结 Step3模块实现 Step4依赖闭合 Step5验收 verdict 多模块 复杂系统 子pipeline
SKILL.md
| 1 | # Code Pipeline 工作流 |
| 2 | |
| 3 | `code-pipeline-skill` 是一个复合组件：它组合 shared agents、模块配对执行单元与可选 skill，在 pipeline 执行期间维护自己的协议与运行态投影；它不定义 shared components 的本体规则。 |
| 4 | |
| 5 | ## 场景入口 |
| 6 | |
| 7 | - 标准模式：单模块、双模块、依赖链短，但仍需要 Step 1 / 3 / 4 / 5 的最小闭环 |
| 8 | - 复杂系统模式：3+ 模块、共享契约重、需要 wave / dispatch / checkpoint / sub-pipeline |
| 9 | - 简单局部改动：若一个 skill 或单个 agent 就能收敛，不值得启 pipeline |
| 10 | - 但只要输入包含 PRD / 外部需求文档 / 设计稿，或执行者尚未掌握该功能域的现有承载面，就不得以“简单局部改动”为由跳过 pipeline；至少先完成一次 Step 1 |
| 11 | |
| 12 | ## AI 读取顺序 |
| 13 | |
| 14 | 1. `SKILL_MEMORY.md` |
| 15 | 2. `config/step_contracts.md` |
| 16 | 3. `config/pipeline_protocol.md` |
| 17 | 4. 进入 `L1+`、多模块协作或需要 Freeze / Closure / Coverage 时，再读 `config/handoff_protocol.md` |
| 18 | 5. 需要 runtime state 真身时，读 `config/runtime_state_schema.md` |
| 19 | 6. 进入复杂系统模式后，再按需读取对应主定义页： |
| 20 | - 总模型：`architecture/orchestration-model.md` |
| 21 | - 状态：`architecture/artifact-state-machine.md` |
| 22 | - barrier / wave / dispatch：`architecture/barrier-and-wave-scheduling.md` |
| 23 | - 子 pipeline：`architecture/subpipeline-strategy.md` |
| 24 | - stalled / recovery：`architecture/stall-recovery.md` |
| 25 | - 局部 / 全局验证：`architecture/verification-architecture.md` |
| 26 | 7. 需要模板或判例时读取 `EXAMPLES.md` 与 `examples/*` |
| 27 | |
| 28 | ## Step 1 快速门 |
| 29 | |
| 30 | - 在 `code-pipeline` 模式下，Step 1 的正文必须显式出现独立的 `### CapabilityScan` block，不能用 Phase 叙事、PRD 摘要或一句“已检索”代替 |
| 31 | - `CapabilityScan` 至少要写出 `MatchedCapabilities`、`CandidateHosts`、`Evidence`、`Recommendation`；即使未命中可复用承载，也必须显式写 `None` / `未命中`，不能省略 |
| 32 | - `Evidence` 只接受项目代码路径、符号、检索范围与命中说明；PRD、用户口述、设计说明只能定义 `scan scope`，不能单独充当源码证据 |
| 33 | - 未满足以上条件时，主流程只能维持 `Discovering` 或 `PendingDecision`，不得宣布 Step 1 完成，更不得进入 Step 2 / Step 3 |
| 34 | |
| 35 | ## 工作流总览 |
| 36 | |
| 37 | Step 1-9 的唯一 Step 收口页与 Step 级强规则入口见 `config/step_contracts.md`；执行期的精确调度合同、状态迁移与读写路径见 `config/pipeline_protocol.md`。本页只回答三件事：什么时候启 pipeline、每一步由谁执行、接下来该深读哪里。 |
| 38 | |
| 39 | Step 1 内部允许按 `DecompositionSnapshot`（拆解快照） -> `CapabilityScan`（能力探寻） -> `ArtifactBinding`（产物绑定） -> `DecisionSynthesis`（决策综合）做认知分治；scan 类任务可以拆给只读 subagent，但 `decision_status`、`Handoff Level Decision`、`Freeze Recommendation` 仍只由 Step 1 聚合层写回。 |
| 40 | |
| 41 | ## Step 导航 |
| 42 | |
| 43 | | Step | 执行单元 | 导航信息 | 深读 | |
| 44 | |---|---|---|---| |
| 45 | | Step 1 | `requirement-analysis-agent` | 先产出 `DecompositionSnapshot`；复杂认知优先拆给只读 scan subagent；若 `CapabilityScan` 无独立 block 或缺少源码 `Evidence`，视为 Step 1 未完成；若存在路线分歧，必须停在决策态，不能直接推进实现 | `config/step_contracts.md`、`config/pipeline_protocol.md` | |
| 46 | | Step 2 | `requirement-analysis-agent` | 只在路线已收敛且命中冻结条件时进入 | `config/step_contracts.md`、`config/pipeline_protocol.md`、`config/handoff_protocol.md` | |
| 47 | | Step 3 | 模块配对执行单元 / `main agent`（`L0`） | 负责实现；进入前必须确认决策态已解决且 Freeze Gate 已过 | `config/step_contracts.md`、`config/pipeline_protocol.md` | |
| 48 | | Step 4 | `integration-matching-agent` | 只做依赖闭合验证，不改代码 | `config/step_contracts.md`、`config/handoff_protocol.md` | |
| 49 | | Step 5 | `pipeline-verify-agent` | 只做 coverage / verdict 决策，不改代码 | `config/step_contracts.md`、`config/pipeline_protocol.md`、`config/handoff_protocol.md` | |
| 50 | | Step 6 | 模块配对执行单元 / `main agent` | 只补 `CompletableBlocks`，补完后至少回 Step 4 | `config/step_contracts.md`、`config/handoff_protocol.md` | |
| 51 | | Step 7 | `debug-skill` | 只在需要边界条件验证时进入 | `config/step_contracts.md` | |
| 52 | | Step 8 | `profiler-skill` | 只在需要性能诊断时进入 | `config/step_contracts.md` | |
| 53 | | Step 9 | `main agent` | 必做收尾；未完成 run_id / signal 清理不得结束 pipeline | `config/step_contracts.md`、`config/pipeline_protocol.md` | |
| 54 | |
| 55 | ## 最小运行心智模型 |
| 56 | |
| 57 | ### 1. 真相与投影分离 |
| 58 | - 运行期 gate 真相由 `PIPELINE_CONTEXT.md` 顶部固定状态头承载 |
| 59 | - `PIPELINE_CONTEXT.md` 正文只做投影与归档 |
| 60 | - `temp/pipeline-output/{module_id}.md` 只承载模块实现结果 |
| 61 | |
| 62 | ### 2. 三个关键门 |
| 63 | - Step 1：先完成 `DecompositionSnapshot`、`CapabilityScan` 与必要的 `ArtifactBinding`，再进入 `DecisionSynthesis` |
| 64 | - Step 2 / Step 3：只有路线已收敛且 Freeze Gate 满足时才允许冻结或实现 |
| 65 | - Step 4 / Step 5：决定是进入 Step 6 补全，还是进入 Step 9 收尾 |
| 66 | |
| 67 | ### 3. 复杂系统模式不是“更多并行” |
| 68 | 复杂系统模式下，主流程看 `ArtifactState`、wave readiness、dispatch scope、checkpoint，而不是把所有模块一次性开工。 |
| 69 | |
| 70 | ## 组件边界 |
| 71 | |
| 72 | - shared inputs：项目 `CLAUDE.md`、`GLOBAL_SKILL_MEMORY.md`、相关 skill 的 `SKILL_MEMORY.md`、shared agents、模块配对执行单元 |
| 73 | - component-owned runtime truth：`PIPELINE_CONTEXT.md` 顶部状态头、pipeline result signal |
| 74 | - component-owned runtime projection：`PIPELINE_CONTEXT.md` 正文、`temp/pipeline-output/{module_id}.md` |
| 75 | - component-owned runtime binding：运行时投影脚本 `pipeline_merge.py` |
| 76 | |
| 77 | ## Step 3 输出归并 |
| 78 | |
| 79 | - 每个模块输出到 `temp/pipeline-output/{module_id}.md` |
| 80 | - 该文件分为两层：`PIPELINE_SUMMARY` 与 `PIPELINE_DETAIL` |
| 81 | - `pipeline_merge.py` 只提取 `PIPELINE_SUMMARY` 并合并回 `PIPELINE_CONTEXT.md` |
| 82 | - Step 4 / Step 5 深读模块实现时，读取 `PIPELINE_DETAIL` |
| 83 | - `Parent Summary` 只用于子 pipeline 回传父 pipeline，不等于 Step 3 模块 summary；定义见 `config/handoff_protocol.md` |
| 84 | |
| 85 | ## 主定义页 |
| 86 | |
| 87 | | 主题 | 文件 | |
| 88 | |---|---| |
| 89 | | 执行期控制、状态迁移、run_id、复杂系统产物 | `config/pipeline_protocol.md` | |
| 90 | | Handoff、Freeze、Closure、Coverage、Parent Summary | `config/handoff_protocol.md` | |
| 91 | | `ArtifactState` 与派发资格 | `architecture/artifact-state-machine.md` | |
| 92 | | barrier / wave / dispatch | `architecture/barrier-and-wave-scheduling.md` | |
| 93 | | 子 pipeline 升级与回传 | `architecture/subpipeline-strategy.md` | |
| 94 | | stalled / heartbeat / checkpoint / recovery | `architecture/stall-recovery.md` | |
| 95 | | 局部 / 全局验证与重跑 | `architecture/verif |
People who liked this also viewed
6 picksType
- hyperframes-cliUse the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, SkillsJul 2026
- request-refactor-planSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- analyze-projectRigor Analyze / Rigor Audit read-only skill for deep learning research repositories. Use when the user wants to read and understand a repository, inspect model structure and training or inference entrSkillsMay 2026
- explore-codeRigor Improve implementation leaf skill for auditable candidate implementation in deep learning research repositories. Use when the researcher explicitly authorizes exploratory work on an isolated braSkillsMay 2026
- ubiquitous-languageSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
- scaffold-exercisesSkills for Real Engineers. Straight from my .agents directory.SkillsJul 2026
