cc-devflow 4.1.6 → 4.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/core/architecture.md +30 -0
- package/.claude/commands/core/guidelines.md +25 -0
- package/.claude/commands/core/roadmap.md +29 -0
- package/.claude/commands/core/style.md +18 -0
- package/.claude/commands/flow/CLAUDE.md +0 -4
- package/.claude/docs/examples/design-inspiration-pool.md +59 -0
- package/.claude/docs/examples/ui-prototype-constitution-checklist.md +75 -0
- package/.claude/docs/implementation-summary-v7.md +449 -0
- package/.claude/docs/spec-format-guide.md +349 -0
- package/.claude/docs/state-consolidation-design.md +323 -0
- package/.claude/docs/templates/ARCHITECTURE_TEMPLATE.md +85 -386
- package/.claude/docs/templates/DESIGN_TEMPLATE.md +157 -0
- package/.claude/docs/templates/PROPOSAL_TEMPLATE.md +91 -0
- package/.claude/docs/templates/SPEC_TEMPLATE_DELTA.md +139 -0
- package/.claude/docs/templates/SPEC_TEMPLATE_PROJECT.md +93 -0
- package/.claude/docs/templates/STYLE_TEMPLATE.md +114 -901
- package/.claude/docs/templates/UI_PROTOTYPE_TEMPLATE.md +143 -1205
- package/.claude/hooks/inject-agent-context.ts +9 -9
- package/.claude/scripts/.claude/commands/flow/export-openspec.md +221 -0
- package/.claude/scripts/.claude/commands/flow/import-openspec.md +171 -0
- package/.claude/scripts/__tests__/openspec.test.js +212 -0
- package/.claude/scripts/delta-parser.ts +112 -2
- package/.claude/scripts/export-openspec.js +222 -0
- package/.claude/scripts/import-openspec.js +272 -0
- package/.claude/scripts/validate-scope.sh +200 -0
- package/.claude/skills/cc-devflow-orchestrator/SKILL.md +25 -0
- package/.claude/skills/flow-dev/SKILL.md +94 -0
- package/.claude/skills/flow-init/SKILL.md +105 -0
- package/.claude/skills/{workflow/flow-release → flow-release}/SKILL.md +14 -3
- package/.claude/skills/flow-spec/SKILL.md +102 -0
- package/.claude/skills/utility/npm-release/CLAUDE.md +55 -0
- package/.claude/skills/utility/npm-release/SKILL.md +111 -46
- package/.claude/skills/utility/npm-release/references/version-decision-guide.md +134 -0
- package/.claude/skills/utility/npm-release/scripts/atomic-version-bump.sh +95 -0
- package/.claude/skills/utility/npm-release/scripts/validate-version-sync.sh +82 -0
- package/.claude/skills/utility/npm-release/scripts/version-decision-tree.sh +44 -0
- package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/affected-repos.txt +1 -0
- package/.claude/tsc-cache/70d2fc6d-2936-429b-b529-429f1aae8c88/edited-files.log +2 -0
- package/CHANGELOG.md +81 -0
- package/README.md +7 -1
- package/README.zh-CN.md +7 -1
- package/bin/cc-devflow-cli.js +154 -0
- package/docs/v4.3.0-migration-guide.md +276 -0
- package/lib/harness/CLAUDE.md +5 -4
- package/lib/harness/__tests__/planner.tdd.test.js +125 -0
- package/lib/harness/index.js +4 -2
- package/lib/harness/operations/dispatch.js +13 -0
- package/lib/harness/operations/plan.js +55 -1
- package/lib/harness/operations/release.js +87 -0
- package/lib/harness/operations/verify.js +14 -0
- package/lib/harness/planner.js +131 -0
- package/lib/harness/query.js +126 -0
- package/lib/harness/schemas.js +22 -1
- package/package.json +1 -1
- package/.claude/commands/flow/checklist.md +0 -18
- package/.claude/commands/flow/clarify.md +0 -18
- package/.claude/commands/flow/new.md +0 -23
- package/.claude/commands/flow/quality.md +0 -21
- package/.claude/docs/templates/EPIC_TEMPLATE.md +0 -805
- package/.claude/docs/templates/PRD_TEMPLATE.md +0 -562
- package/.claude/docs/templates/TASKS_TEMPLATE.md +0 -523
- package/.claude/docs/templates/TECH_DESIGN_TEMPLATE.md +0 -1019
- package/.claude/skills/workflow/CLAUDE.md +0 -24
- package/.claude/skills/workflow/flow-dev/SKILL.md +0 -58
- package/.claude/skills/workflow/flow-init/SKILL.md +0 -55
- package/.claude/skills/workflow/flow-spec/SKILL.md +0 -42
- /package/.claude/skills/{domain/attention-refresh → attention-refresh}/SKILL.md +0 -0
- /package/.claude/skills/{domain/brainstorming → brainstorming}/SKILL.md +0 -0
- /package/.claude/skills/{guardrail/constitution-guardian → constitution-guardian}/SKILL.md +0 -0
- /package/.claude/skills/{utility/constitution-quick-ref → constitution-quick-ref}/SKILL.md +0 -0
- /package/.claude/skills/{domain/debugging → debugging}/SKILL.md +0 -0
- /package/.claude/skills/{utility/file-standards → file-standards}/SKILL.md +0 -0
- /package/.claude/skills/{domain/finishing-branch → finishing-branch}/SKILL.md +0 -0
- /package/.claude/skills/{workflow/flow-dev → flow-dev}/CLAUDE.md +0 -0
- /package/.claude/skills/{workflow/flow-dev → flow-dev}/assets/IMPLEMENTATION_PLAN_TEMPLATE.md +0 -0
- /package/.claude/skills/{workflow/flow-dev → flow-dev}/context.jsonl +0 -0
- /package/.claude/skills/{workflow/flow-dev → flow-dev}/dev-implementer.jsonl +0 -0
- /package/.claude/skills/{workflow/flow-dev → flow-dev}/scripts/entry-gate.sh +0 -0
- /package/.claude/skills/{workflow/flow-dev → flow-dev}/scripts/exit-gate.sh +0 -0
- /package/.claude/skills/{workflow/flow-dev → flow-dev}/scripts/task-orchestrator.sh +0 -0
- /package/.claude/skills/{workflow/flow-fix → flow-fix}/SKILL.md +0 -0
- /package/.claude/skills/{workflow/flow-fix → flow-fix}/context.jsonl +0 -0
- /package/.claude/skills/{workflow/flow-fix → flow-fix}/references/bug-analyzer.md +0 -0
- /package/.claude/skills/{workflow/flow-init → flow-init}/assets/BRAINSTORM_TEMPLATE.md +0 -0
- /package/.claude/skills/{workflow/flow-init → flow-init}/assets/INIT_FLOW_TEMPLATE.md +0 -0
- /package/.claude/skills/{workflow/flow-init → flow-init}/assets/RESEARCH_TEMPLATE.md +0 -0
- /package/.claude/skills/{workflow/flow-init → flow-init}/context.jsonl +0 -0
- /package/.claude/skills/{workflow/flow-init → flow-init}/references/flow-researcher.md +0 -0
- /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/check-prerequisites.sh +0 -0
- /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/consolidate-research.sh +0 -0
- /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/create-requirement.sh +0 -0
- /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/generate-research-tasks.sh +0 -0
- /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/populate-research-tasks.sh +0 -0
- /package/.claude/skills/{workflow/flow-init → flow-init}/scripts/validate-research.sh +0 -0
- /package/.claude/skills/{workflow/flow-quality → flow-quality}/SKILL.md +0 -0
- /package/.claude/skills/{workflow/flow-quality → flow-quality}/context.jsonl +0 -0
- /package/.claude/skills/{workflow/flow-quality → flow-quality}/references/code-quality-reviewer.md +0 -0
- /package/.claude/skills/{workflow/flow-quality → flow-quality}/references/qa-tester.md +0 -0
- /package/.claude/skills/{workflow/flow-quality → flow-quality}/references/security-reviewer.md +0 -0
- /package/.claude/skills/{workflow/flow-quality → flow-quality}/references/spec-reviewer.md +0 -0
- /package/.claude/skills/{workflow/flow-release → flow-release}/context.jsonl +0 -0
- /package/.claude/skills/{workflow/flow-release → flow-release}/references/release-manager.md +0 -0
- /package/.claude/skills/{workflow/flow-spec → flow-spec}/CLAUDE.md +0 -0
- /package/.claude/skills/{workflow/flow-spec → flow-spec}/context.jsonl +0 -0
- /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/entry-gate.sh +0 -0
- /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/exit-gate.sh +0 -0
- /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/parallel-orchestrator.sh +0 -0
- /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/team-communication.sh +0 -0
- /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/team-init.sh +0 -0
- /package/.claude/skills/{workflow/flow-spec → flow-spec}/scripts/test-team-mode.sh +0 -0
- /package/.claude/skills/{workflow/flow-spec → flow-spec}/team-config.json +0 -0
- /package/.claude/skills/{workflow/flow-verify → flow-verify}/CLAUDE.md +0 -0
- /package/.claude/skills/{workflow/flow-verify → flow-verify}/SKILL.md +0 -0
- /package/.claude/skills/{workflow/flow-verify → flow-verify}/context.jsonl +0 -0
- /package/.claude/skills/{utility/fractal-docs → fractal-docs}/SKILL.md +0 -0
- /package/.claude/skills/{utility/journey-checker → journey-checker}/SKILL.md +0 -0
- /package/.claude/skills/{utility/journey-checker → journey-checker}/pressure-scenarios.md +0 -0
- /package/.claude/skills/{domain/receiving-review → receiving-review}/SKILL.md +0 -0
- /package/.claude/skills/{utility/skill-creator → skill-creator}/LICENSE.txt +0 -0
- /package/.claude/skills/{utility/skill-creator → skill-creator}/SKILL.md +0 -0
- /package/.claude/skills/{utility/skill-creator → skill-creator}/references/output-patterns.md +0 -0
- /package/.claude/skills/{utility/skill-creator → skill-creator}/references/workflows.md +0 -0
- /package/.claude/skills/{utility/skill-creator → skill-creator}/scripts/init_skill.py +0 -0
- /package/.claude/skills/{utility/skill-creator → skill-creator}/scripts/package_skill.py +0 -0
- /package/.claude/skills/{utility/skill-creator → skill-creator}/scripts/quick_validate.py +0 -0
- /package/.claude/skills/{domain/tdd → tdd}/SKILL.md +0 -0
- /package/.claude/skills/{guardrail/tdd-enforcer → tdd-enforcer}/SKILL.md +0 -0
- /package/.claude/skills/{domain/verification → verification}/SKILL.md +0 -0
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
# workflow/
|
|
2
|
-
> L2 | 父级: /Users/dimon/001Area/80-CodeWorld/002-devflow/cc-devflow/.claude/CLAUDE.md
|
|
3
|
-
|
|
4
|
-
成员清单
|
|
5
|
-
flow-init/SKILL.md: 需求初始化入口,调用 harness:init + harness:pack。
|
|
6
|
-
flow-init/context.jsonl: flow-init 的上下文注入定义。
|
|
7
|
-
flow-spec/SKILL.md: 计划生成入口,调用 harness:plan 产出 task-manifest。
|
|
8
|
-
flow-spec/context.jsonl: flow-spec 的上下文注入定义。
|
|
9
|
-
flow-spec/team-config.json: 旧 Team 配置资产(兼容保留,当前主链不依赖)。
|
|
10
|
-
flow-dev/SKILL.md: 执行入口,调用 harness:dispatch/resume 并写 checkpoint/events。
|
|
11
|
-
flow-dev/context.jsonl: flow-dev 的上下文注入定义。
|
|
12
|
-
flow-dev/dev-implementer.jsonl: 旧 dev-implementer 上下文(兼容保留)。
|
|
13
|
-
flow-verify/SKILL.md: 质量门禁入口,调用 harness:verify 输出 report-card。
|
|
14
|
-
flow-verify/context.jsonl: flow-verify 的上下文注入定义。
|
|
15
|
-
flow-release/SKILL.md: 发布入口,调用 harness:release + harness:janitor。
|
|
16
|
-
flow-release/context.jsonl: flow-release 的上下文注入定义。
|
|
17
|
-
flow-quality/SKILL.md: 旧质量流程技能(迁移过渡保留)。
|
|
18
|
-
flow-quality/context.jsonl: 旧质量流程上下文(迁移过渡保留)。
|
|
19
|
-
flow-fix/SKILL.md: Bug 修复流程技能。
|
|
20
|
-
flow-fix/context.jsonl: flow-fix 的上下文注入定义。
|
|
21
|
-
|
|
22
|
-
法则: 成员完整·一行一文件·父级链接·技术词前置
|
|
23
|
-
|
|
24
|
-
[PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md
|
|
@@ -1,58 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: flow-dev
|
|
3
|
-
description: 'Execute task-manifest with dependency-aware parallel dispatch and checkpoint recovery. Use when implementing planned tasks for a requirement.'
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Flow-Dev Skill
|
|
7
|
-
|
|
8
|
-
> [PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md
|
|
9
|
-
|
|
10
|
-
## Purpose
|
|
11
|
-
|
|
12
|
-
执行 `task-manifest.json` 中的任务,默认并行调度并写入 checkpoint/events 供恢复。
|
|
13
|
-
|
|
14
|
-
## Input Format
|
|
15
|
-
|
|
16
|
-
```bash
|
|
17
|
-
/flow:dev "REQ_ID" [--parallel N] [--resume] [--max-retries N]
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
## Execution Steps
|
|
21
|
-
|
|
22
|
-
1. 解析参数:
|
|
23
|
-
- 默认 `parallel = 3`
|
|
24
|
-
- 默认不 resume
|
|
25
|
-
2. 分支执行:
|
|
26
|
-
- 普通执行:
|
|
27
|
-
|
|
28
|
-
```bash
|
|
29
|
-
npm run harness:dispatch -- --change-id "${REQ_ID}" --parallel ${PARALLEL} [--max-retries ${MAX_RETRIES}]
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
- 恢复执行:
|
|
33
|
-
|
|
34
|
-
```bash
|
|
35
|
-
npm run harness:resume -- --change-id "${REQ_ID}" --parallel ${PARALLEL} [--max-retries ${MAX_RETRIES}]
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
3. 检查执行结果:
|
|
39
|
-
- `task-manifest.json` 状态更新
|
|
40
|
-
- `.harness/runtime/${REQ_ID}/<TASK_ID>/events.jsonl`
|
|
41
|
-
- `.harness/runtime/${REQ_ID}/<TASK_ID>/checkpoint.json`
|
|
42
|
-
|
|
43
|
-
## Exit Criteria
|
|
44
|
-
|
|
45
|
-
- 所有任务状态为 `passed` 或 `skipped`
|
|
46
|
-
- 没有 `running` 残留状态
|
|
47
|
-
|
|
48
|
-
## Failure Handling
|
|
49
|
-
|
|
50
|
-
- 若存在 `failed` 任务:
|
|
51
|
-
1. 修复失败原因
|
|
52
|
-
2. 重新运行 `--resume`
|
|
53
|
-
|
|
54
|
-
## Next Step
|
|
55
|
-
|
|
56
|
-
```bash
|
|
57
|
-
/flow:verify "${REQ_ID}"
|
|
58
|
-
```
|
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: flow-init
|
|
3
|
-
description: 'Initialize a requirement with harness state and context package. Use when starting a new REQ/BUG and preparing deterministic execution context for the next stages.'
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Flow-Init Skill
|
|
7
|
-
|
|
8
|
-
> [PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md
|
|
9
|
-
|
|
10
|
-
## Purpose
|
|
11
|
-
|
|
12
|
-
初始化需求目录的 harness 运行状态,并生成可执行上下文包。
|
|
13
|
-
|
|
14
|
-
## Input Format
|
|
15
|
-
|
|
16
|
-
```bash
|
|
17
|
-
/flow:init "REQ_ID|TITLE|PLAN_URLS?"
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
- `REQ_ID`: `REQ-123` 或 `BUG-123`
|
|
21
|
-
- `TITLE`: 需求标题
|
|
22
|
-
- `PLAN_URLS`: 可选,逗号分隔
|
|
23
|
-
|
|
24
|
-
## Execution Steps
|
|
25
|
-
|
|
26
|
-
1. 解析输入,提取 `REQ_ID`、`TITLE`、`PLAN_URLS`。
|
|
27
|
-
2. 组装 goal 文本:
|
|
28
|
-
- `Deliver <REQ_ID>: <TITLE>`
|
|
29
|
-
- 若有 URL,追加 `Sources: <URLS>`。
|
|
30
|
-
3. 运行初始化:
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
npm run harness:init -- --change-id "${REQ_ID}" --goal "${GOAL}"
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
4. 运行上下文打包:
|
|
37
|
-
|
|
38
|
-
```bash
|
|
39
|
-
npm run harness:pack -- --change-id "${REQ_ID}" --goal "${GOAL}"
|
|
40
|
-
```
|
|
41
|
-
|
|
42
|
-
5. 验证输出文件:
|
|
43
|
-
- `devflow/requirements/${REQ_ID}/harness-state.json`
|
|
44
|
-
- `devflow/requirements/${REQ_ID}/context-package.md`
|
|
45
|
-
|
|
46
|
-
## Exit Criteria
|
|
47
|
-
|
|
48
|
-
- `harness-state.json.status == "initialized"`
|
|
49
|
-
- `context-package.md` 存在并包含 Next Commands 段落
|
|
50
|
-
|
|
51
|
-
## Next Step
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
/flow:spec "${REQ_ID}"
|
|
55
|
-
```
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: flow-spec
|
|
3
|
-
description: 'Generate and refresh task-manifest for a requirement. Use when converting requirement context into dependency-aware executable tasks.'
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Flow-Spec Skill
|
|
7
|
-
|
|
8
|
-
> [PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md
|
|
9
|
-
|
|
10
|
-
## Purpose
|
|
11
|
-
|
|
12
|
-
将需求上下文转换为 `task-manifest.json`,作为后续执行唯一任务源。
|
|
13
|
-
|
|
14
|
-
## Input Format
|
|
15
|
-
|
|
16
|
-
```bash
|
|
17
|
-
/flow:spec "REQ_ID" [--overwrite]
|
|
18
|
-
```
|
|
19
|
-
|
|
20
|
-
## Execution Steps
|
|
21
|
-
|
|
22
|
-
1. 解析 `REQ_ID` 和可选 `--overwrite`。
|
|
23
|
-
2. 运行计划生成:
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
npm run harness:plan -- --change-id "${REQ_ID}" [--overwrite]
|
|
27
|
-
```
|
|
28
|
-
|
|
29
|
-
3. 校验输出:
|
|
30
|
-
- `devflow/requirements/${REQ_ID}/task-manifest.json`
|
|
31
|
-
- `tasks` 数组非空,`id/dependsOn/run` 字段完整
|
|
32
|
-
|
|
33
|
-
## Exit Criteria
|
|
34
|
-
|
|
35
|
-
- `task-manifest.json` 可通过 schema 校验
|
|
36
|
-
- 任务依赖图无自循环(由 planner 保障)
|
|
37
|
-
|
|
38
|
-
## Next Step
|
|
39
|
-
|
|
40
|
-
```bash
|
|
41
|
-
/flow:dev "${REQ_ID}"
|
|
42
|
-
```
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
/package/.claude/skills/{workflow/flow-dev → flow-dev}/assets/IMPLEMENTATION_PLAN_TEMPLATE.md
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
/package/.claude/skills/{workflow/flow-quality → flow-quality}/references/code-quality-reviewer.md
RENAMED
|
File without changes
|
|
File without changes
|
/package/.claude/skills/{workflow/flow-quality → flow-quality}/references/security-reviewer.md
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
/package/.claude/skills/{workflow/flow-release → flow-release}/references/release-manager.md
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
/package/.claude/skills/{utility/skill-creator → skill-creator}/references/output-patterns.md
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|