just-do-it

Files (2)

• SKILL.md
• openai.yaml · agents/

SKILL.md (first lines)

# just-do-it — 小改动直通车（零规划零责任）

> **纯执行器**：主人一句话说清的小活（微小改动 / 单个页面 / 小工具），不规划、不定位，dev 写完 qa 验，记一笔就结束。
> **主控只编排**：不扮演任何角色，不写任何文件——代码归 dev，验收记录归 qa（角色权限唯一出处 = `.cc_code/active/Agent.md` §三）。
> **零责任声明**：不做断言对账、不做全量回归、不更新 status/milestone——快，是拿深度换的。
> **与 agent-feature 的分界**：需求一句话说不清、要动契约/动架构、要追溯既有断言 → 拒绝执行，指路 `/cc-code:plan-feature`。
> **前端文件只做静态扫描**：改动命中前端源码时，只跑 `../cc-code/references/ui-gates.md` 组 02（依赖与源码扫描）里可静态判定的阻断子集，**只记录、不出判词、不阻断、不进分母**；⛔ 不读 `design.md`、不碰基线、不启动浏览器、不跑性能。

## 前置检查（启动时一次性）

1. 确认双 agent 可用：`dev` / `qa`。
2. 需求可一句话说清（说不清 → 拒跑指路规划，⛔ 不现场推需求）。
3. ⛔ 不需要 `.cc_code/`、不读 prd/ux/project、不读 status.md——需求唯一来源 = 主人原话。
4. 改动命中前端文件 → 只做静态扫描（规则见上）；命中由 `design.md` 生成的主题文件 → 必须让 dev 改生成器 / 按项目约定重新生成，⛔ 不手改生成物。

## 运行逻辑

```
主人一句话需求
      │
      ▼
① dev 直接改 + 自检（只跑项目测试基建契约里登记的命令，没有就跳过）
      │
      ▼
② qa 只拿「主人原话」当尺子验一遍
      │
   ┌──┴───────────┐
   ▼              ▼
 FAIL→回dev     PASS
 (≤2轮)          │
   │             ▼
 仍FAIL→交人   ③ qa 记一笔 → 结束
```

## ① Dev 段（agent: dev）

| 项 | 内容 |
| --- | --- |
| 读 | 仅需求涉及的代码文件（最小集）；项目有 `.cc_code/` 时派单另列 `.cc_code/references/INDEX.md`（经验索引，命中主题才打开；规则见 `Agent.md` §四第 7 条），没有 `.cc_code/` 不列 |
| 做 | 只按主人原话实现；⛔ 不顺手重构无关代码、不擅自扩大范围 |
| 自检 | 有 `.cc_code/` 且 `project.md` §六「测试基建契约」登记了命令 → 按契约跑；没有契约 → 跳过（不补基建、⛔ 不自带命令） |
| 冲突 | 主人原话与项目既有需求 / 契约（若有）明显冲突 → 停下，交回主控，由主控交人，⛔ 不自己拍板 |
| 输出 | 改动文件清单 + 每个文件干了啥 + 自检结果；有 `.cc_code/` 时加「采纳经验」一行（格式见 `Agent.md` §四第 7 条），缺则主控续接 dev 补 |

## ② QA 段（agent: qa）

| 项 | 内容 |
| --- | --- |
| 尺子 | **只有主人原话**（⛔ 不读 prd 断言、不做追溯矩阵） |
| 验 | 需求点逐条过一遍；能跑则实测（测试命令取自测试基建契约，没有就手动驱动），跑不了则代码走查 |
| 前端静态扫描（仅命中前端文件） | 跑 `ui-gates.md` 组 02 里可静态判定的阻断子集（家族/图标/动画库数量、片段兼容与隔离、主题入口外写死色值、移动端整屏 vh / z-index / transition all / 布局属性动画）；**只记录不阻断**，明细写进「遗留」 |
| 输出 | Verdict（PASS / FAIL 清单）+ 下节五件套 |
| 回环 | FAIL → 主控原样喂回 dev，≤2 轮；仍 FAIL → 直接交人决策，⛔ 不硬修、不回规划 |

## ③ 记一笔（唯一善后，qa 写，主控不代写）

| 场景 | 落点 |
| :--- | :--- |
| 项目有 `.cc_code/active/gates.md` | **qa** 在 gates.md 的「just-do-it 记录」小节就地更新：只留最近一条，上一条原文整段搬 `backup/retired/gates.md`（规则出处 = `active/Agent.md` §四第 5 条） |
| 项目没有 `.cc_code/` | ⛔ 不落盘、⛔ 不在项目根另起 `gates.md` 或任何记录文件；qa 把五件套交回，主控原样呈给主人，对话即记录 |

**结算后台派 curator（仅项目有 `.cc_code/` 时）**：PASS 或 2 轮仍 FAIL 交人，都由主控后台派一次（规则见 `.cc_code/active/Agent.md` §四第 7 条、§五）；结果并入报告的方式见 `active/Agent.md` §五「派 curator」。本命令的 qa 不填验收矩阵的「连续 / 回归」标记（只留最近一条记录），所以这里通常只做采纳记账。没有 `.cc_code/` 不派。

五件套（qa 产出）：

```
## just-do-it YYYY-MM-DD HH:mm
- 需求原话：<主人原话，一字不改>
- 改动文件：<文件清单>
- 每个文件干了啥：<逐文件一行说明>
- qa 结论：<PASS / FAIL 要点 + 复测轮数>
- 视觉静态扫描：<命中 N 条；明细见「遗留」 / 未命中写「无」 / 未命中前端写「不适用」>
- 遗留：<没做完 / 没验到的；视觉静态扫描命中项逐条写「规则号 + 位置」，没有就写「无」>
```

## 铁律

- **不碰**：status.md / milestone-log.md / prd.md / ux.md / design.md / 契约文档 / 截图基线；主控自己一个文件都不写。
- **前端只做静态扫描**：只跑 `ui-gates.md` 组 02 的静态子集，只记录、不出判词、不进分母、不阻断；⛔ 不启动浏览器、⛔ 不跑性能采样、⛔ 不碰 `.cc_code/test/visual/`。
- **主题生成物禁手改**：命中生成的主题文件 → 让 dev 改生成器或按项目约定重新生成，⛔ 手改成生成物。
- **不负责**：不改回滚方案、不做回归承诺、不测无关面——记录在案即免责。
- **subagent 不能问用户**：dev / qa 要问人的事交回主控，由主控交人。
- **中途零确认**：跑完一次性报告结果；只有「需求说不清」「与既有需求 / 契约冲突」和「2 轮仍 FAIL」才打断主人。

From weiyi88/cc-code, MIT.

More from weiyi88/cc-code