easy-coding-harness 0.8.3 → 0.9.0-beta.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.
Files changed (31) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +16 -10
  3. package/dist/cli.js +256 -47
  4. package/dist/cli.js.map +1 -1
  5. package/package.json +1 -1
  6. package/templates/claude/agents/ec-fixer.md +3 -2
  7. package/templates/claude/agents/ec-implementer.md +4 -1
  8. package/templates/claude/agents/ec-reviewer.md +4 -2
  9. package/templates/claude/agents/ec-verifier.md +6 -3
  10. package/templates/codex/agents/ec-fixer.toml +3 -2
  11. package/templates/codex/agents/ec-implementer.toml +4 -1
  12. package/templates/codex/agents/ec-reviewer.toml +4 -2
  13. package/templates/codex/agents/ec-verifier.toml +6 -3
  14. package/templates/common/bundled-skills/ec-meta/references/local-architecture/README.md +9 -7
  15. package/templates/common/skills/ec-analysis/SKILL.md +92 -266
  16. package/templates/common/skills/ec-implementing/SKILL.md +82 -131
  17. package/templates/common/skills/ec-memory/SKILL.md +23 -149
  18. package/templates/common/skills/ec-reviewing/SKILL.md +54 -73
  19. package/templates/common/skills/ec-task-management/SKILL.md +34 -94
  20. package/templates/common/skills/ec-verification/SKILL.md +54 -79
  21. package/templates/common/skills/ec-workflow/SKILL.md +109 -302
  22. package/templates/main-constraint/AGENTS.md.tpl +19 -17
  23. package/templates/main-constraint/CLAUDE.md.tpl +19 -17
  24. package/templates/qoder/agents/ec-fixer.md +3 -2
  25. package/templates/qoder/agents/ec-implementer.md +4 -1
  26. package/templates/qoder/agents/ec-reviewer.md +4 -2
  27. package/templates/qoder/agents/ec-verifier.md +6 -3
  28. package/templates/runtime/memory/SHORT_MEMORY_TEMPLATE.md +2 -0
  29. package/templates/runtime/templates/dev-spec-skeleton.md +14 -6
  30. package/templates/shared-hooks/easy_coding_state.py +1240 -89
  31. package/templates/shared-hooks/inject-subagent-context.py +3 -0
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ec-implementer
3
- description: Easy Coding implementation sub-agent. Implements one confirmed execution unit within a strict file scope and returns structured results.
3
+ description: Easy Coding implementation sub-agent. Implements one workflow-mode task card within strict scope and returns structured results.
4
4
  skills: []
5
5
  mcpServers: []
6
6
  ---
@@ -18,6 +18,8 @@ complete exactly that unit. Your reply IS the return value, not a message to a h
18
18
  context is in the card.
19
19
  - Make no workflow stage-transition decisions; you do not know the state machine exists.
20
20
  - Follow the coding rules and architecture context embedded in the card.
21
+ - Treat acceptance criteria, test points, contracts, and risks in the card as required inputs.
22
+ - Run the exact targeted checks requested by the card and report their real outcome.
21
23
  - Preserve each existing file's original encoding; never silently convert.
22
24
 
23
25
  ## Output (return exactly this)
@@ -27,5 +29,6 @@ complete exactly that unit. Your reply IS the return value, not a message to a h
27
29
  - `deliverable`: full no-code result, or `null` for a code unit
28
30
  - `issues`: problems you hit (empty array if none)
29
31
  - `needs_attention`: anything the main agent must decide (empty array if none)
32
+ - `checks`: commands run with pass/fail outcomes
30
33
 
31
34
  Do not claim a file is verified unless the card asked you to run a check and you ran it.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ec-reviewer
3
- description: Easy Coding review sub-agent. Reviews changed files along one assigned dimension and returns evidence-backed findings.
3
+ description: Easy Coding review sub-agent. Reviews assigned risk dimensions and returns acceptance-aware findings.
4
4
  skills: []
5
5
  mcpServers: []
6
6
  ---
@@ -18,6 +18,8 @@ dimension named in your task card. Your reply IS the return value.
18
18
  null/empty handling, races, off-by-one.
19
19
  - compliance → does the code obey the RULES sections in the card? naming, format, comment
20
20
  language, error handling.
21
+ - `error` means a demonstrated acceptance, contract, security, or build failure. Use `warning`
22
+ for a credible risk and `info` for non-blocking maintainability advice.
21
23
 
22
24
  ## Hard constraints
23
25
 
@@ -28,5 +30,5 @@ dimension named in your task card. Your reply IS the return value.
28
30
  ## Output (return exactly this)
29
31
 
30
32
  - `dimension`: your assigned dimension
31
- - `findings`: array of `{file, line, issue, severity}` (`severity`: info | warn | error)
33
+ - `findings`: array of `{file, line, issue, severity}` (`severity`: info | warning | error)
32
34
  - `suggestion`: optional fix direction per finding
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: ec-verifier
3
- description: Easy Coding verification sub-agent. Runs one verification check and reports fresh evidence.
3
+ description: Easy Coding verification sub-agent. Runs one requested check and returns fingerprint-ready evidence.
4
4
  skills: []
5
5
  mcpServers: []
6
6
  ---
@@ -16,7 +16,8 @@ pass.
16
16
 
17
17
  ## What to do
18
18
 
19
- - Run the exact command the card specifies (e.g. `npm run lint`, `tsc --noEmit`, `npm test`).
19
+ - Run the exact command the card specifies (e.g. `npm run lint`, `tsc --noEmit`, `npm test`,
20
+ `npm run build`).
20
21
  - Capture the real exit status and output.
21
22
 
22
23
  ## Hard constraints
@@ -26,7 +27,9 @@ pass.
26
27
 
27
28
  ## Output (return exactly this)
28
29
 
29
- - `check_type`: lint | typecheck | test
30
+ - `check_type`: lint | typecheck | test | build
30
31
  - `passed`: true | false (from the real exit status)
31
32
  - `failures`: array of failure messages (empty if passed)
32
33
  - `command_output`: the relevant tail of stdout/stderr
34
+ - `implementation_fingerprint`: copy unchanged from the task card
35
+ - `config_fingerprint`: copy unchanged from the task card
@@ -5,6 +5,7 @@ source_task: MM-DD-task-slug
5
5
  date: YYYY-MM-DD
6
6
  task_type: feature | bugfix | refactor | perf | doc | workflow
7
7
  project_mode: startup | iteration
8
+ workflow_mode: fast | standard | strict
8
9
  domain:
9
10
  - "{business domain or module}"
10
11
  tags:
@@ -38,6 +39,7 @@ target_long: BUSINESS | TECHNICAL | BOTH | NONE
38
39
  - Scope: {modules, pages, interfaces, or files involved}
39
40
  - Result: {completed / partially completed / not completed, with reasons}
40
41
  - Key Constraints: {encoding, compatibility, interface, spec, or user-specified constraints; "none" if none}
42
+ - Workflow Mode: {frozen mode and why it was selected or escalated}
41
43
 
42
44
  ## Execution Evidence
43
45
 
@@ -49,16 +49,16 @@
49
49
 
50
50
  ### 实施拆解
51
51
 
52
- | 单元 | 说明 | 类型 | 涉及文件 | 依赖 |
53
- |------|------|------|---------|------|
54
- | U1 | [[EC_TODO:单元标题]] | [[EC_TODO:backend/frontend/test/...]] | [[EC_TODO:涉及文件]] | — |
55
- | U2 | [[EC_TODO:单元标题]] | [[EC_TODO:单元类型]] | [[EC_TODO:涉及文件]] | — |
56
- | U3 | [[EC_TODO:单元标题]] | [[EC_TODO:单元类型]] | [[EC_TODO:涉及文件]] | U1, U2 |
52
+ | 单元 | 说明 | 类型 | 涉及文件 | 依赖 | 验收条件 | 测试点 | 跨单元契约 |
53
+ |------|------|------|---------|------|---------|-------|-----------|
54
+ | U1 | [[EC_TODO:单元标题]] | [[EC_TODO:backend/frontend/test/...]] | [[EC_TODO:涉及文件]] | — | [[EC_TODO:可验证结果]] | [[EC_TODO:定向验证]] | [[EC_TODO:输入输出或“无”]] |
55
+ | U2 | [[EC_TODO:单元标题]] | [[EC_TODO:单元类型]] | [[EC_TODO:涉及文件]] | — | [[EC_TODO:可验证结果]] | [[EC_TODO:定向验证]] | [[EC_TODO:输入输出或“无”]] |
56
+ | U3 | [[EC_TODO:单元标题]] | [[EC_TODO:单元类型]] | [[EC_TODO:涉及文件]] | U1, U2 | [[EC_TODO:可验证结果]] | [[EC_TODO:定向验证]] | [[EC_TODO:与 U1/U2 的契约]] |
57
57
 
58
58
  **执行策略**:[[EC_TODO:parallel / sequential / single]]
59
59
  - 第一批(并行):U1 [[EC_TODO:单元标题]] | U2 [[EC_TODO:单元标题]]
60
60
  - 第二批(等待第一批):U3 [[EC_TODO:单元标题]]
61
- (若 single:单一实施单元,派发 1 个子代理执行)
61
+ (若 single:按 Workflow Mode 决定由主 Agent 直接执行或派发子 Agent)
62
62
 
63
63
  ### 测试策略
64
64
 
@@ -70,6 +70,14 @@
70
70
  - **人工验收**:[[EC_TODO:用户需要检查的关键行为]]
71
71
  - **无法验证项**:[[EC_TODO:无 / 说明缺失环境、数据或权限]]
72
72
 
73
+ ### Workflow Mode
74
+ - **项目配置**:[[EC_TODO:adaptive / fast / standard / strict]]
75
+ - **Session 覆盖**:[[EC_TODO:无 / adaptive / fast / standard / strict]]
76
+ - **机械最低模式**:[[EC_TODO:fast / standard / strict]]
77
+ - **推荐并选择**:[[EC_TODO:fast / standard / strict]]
78
+ - **选择原因**:[[EC_TODO:风险、范围和兼容性依据]]
79
+ - **状态内执行差异**:[[EC_TODO:IMPLEMENT / REVIEW / VERIFICATION / MEMORY 将采用的深度]]
80
+
73
81
  ### 风险与注意事项
74
82
  - [[EC_TODO:风险 1]]
75
83
  - [[EC_TODO:风险 2]]