@ai-content-space/loopx 0.2.3 → 0.2.7

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 (56) hide show
  1. package/README.md +106 -10
  2. package/README.zh-CN.md +106 -10
  3. package/docs/loopx/design/finish/345/255/246/344/271/240/345/256/241/350/256/241/351/234/200/346/261/202/350/256/276/350/256/241/346/226/207/346/241/243.md +707 -0
  4. package/docs/loopx/memory/2026-06-09-stale-archive-hook-guidance.md +15 -0
  5. package/docs/loopx/memory/README.md +25 -0
  6. package/docs/loopx/plans/2026-06-08-finish-audit-change-window.md +933 -0
  7. package/docs/loopx/plans/2026-06-08-finish-learning-audit.md +410 -0
  8. package/docs/loopx/plans/2026-06-09-cli-onboarding-install-surface.md +1277 -0
  9. package/docs/loopx/specs/installation.md +33 -0
  10. package/package.json +18 -2
  11. package/plugins/loopx/.codex-plugin/plugin.json +1 -1
  12. package/plugins/loopx/skills/clarify/SKILL.md +1 -1
  13. package/plugins/loopx/skills/debug/SKILL.md +1 -1
  14. package/plugins/loopx/skills/doc-readability/SKILL.md +222 -0
  15. package/plugins/loopx/skills/doc-readability/references/prd.md +269 -0
  16. package/plugins/loopx/skills/exec/SKILL.md +11 -1
  17. package/plugins/loopx/skills/final-review/SKILL.md +1 -1
  18. package/plugins/loopx/skills/finish/SKILL.md +39 -7
  19. package/plugins/loopx/skills/fix-review/SKILL.md +1 -1
  20. package/plugins/loopx/skills/go-style/SKILL.md +1 -1
  21. package/plugins/loopx/skills/kratos/SKILL.md +1 -1
  22. package/plugins/loopx/skills/plan/SKILL.md +1 -1
  23. package/plugins/loopx/skills/refactor-plan/SKILL.md +1 -1
  24. package/plugins/loopx/skills/review/SKILL.md +1 -1
  25. package/plugins/loopx/skills/spec/SKILL.md +1 -1
  26. package/plugins/loopx/skills/subagent-exec/SKILL.md +13 -1
  27. package/plugins/loopx/skills/tdd/SKILL.md +1 -1
  28. package/plugins/loopx/skills/verify/SKILL.md +1 -1
  29. package/scripts/claude-workflow-hook.mjs +50 -1
  30. package/scripts/codex-workflow-hook.mjs +33 -12
  31. package/scripts/install-skills.mjs +58 -3
  32. package/scripts/verify-skills.mjs +83 -7
  33. package/skills/RESOLVER.md +3 -1
  34. package/skills/clarify/SKILL.md +1 -1
  35. package/skills/debug/SKILL.md +1 -1
  36. package/skills/doc-readability/SKILL.md +222 -0
  37. package/skills/doc-readability/references/prd.md +269 -0
  38. package/skills/exec/SKILL.md +11 -1
  39. package/skills/final-review/SKILL.md +1 -1
  40. package/skills/finish/SKILL.md +39 -7
  41. package/skills/fix-review/SKILL.md +1 -1
  42. package/skills/go-style/SKILL.md +1 -1
  43. package/skills/kratos/SKILL.md +1 -1
  44. package/skills/plan/SKILL.md +1 -1
  45. package/skills/refactor-plan/SKILL.md +1 -1
  46. package/skills/review/SKILL.md +1 -1
  47. package/skills/spec/SKILL.md +1 -1
  48. package/skills/subagent-exec/SKILL.md +13 -1
  49. package/skills/tdd/SKILL.md +1 -1
  50. package/skills/verify/SKILL.md +1 -1
  51. package/src/cli.mjs +473 -86
  52. package/src/finish-runtime.mjs +1184 -0
  53. package/src/install-discovery.mjs +38 -0
  54. package/src/next-skill.mjs +8 -10
  55. package/src/workflow.mjs +19 -26
  56. package/skills/deepsearch/SKILL.md +0 -38
@@ -3,7 +3,7 @@ name: refactor-plan
3
3
  description: "Creates a behavior-preserving refactor plan with user interview, repo evidence, tiny commits, scope boundaries, and testing decisions. Not for feature changes or immediate implementation."
4
4
  when_to_use: "refactor-plan, refactor request, refactoring RFC, tiny commits, behavior-preserving cleanup, architecture cleanup, 重构计划"
5
5
  metadata:
6
- version: "0.2.3"
6
+ version: "0.2.7"
7
7
  ---
8
8
 
9
9
  This skill will be invoked when the user wants to create a refactor request. You should go through the steps below. You may skip steps if you don't consider them necessary.
@@ -3,7 +3,7 @@ name: review
3
3
  description: "Dispatches a loopx code reviewer subagent against a concrete git range and requirements. Not for implementation, planning, or unresolved review scope."
4
4
  when_to_use: "request code review, completed task review, major feature review, pre-merge review, subagent code quality check"
5
5
  metadata:
6
- version: "0.2.3"
6
+ version: "0.2.7"
7
7
  ---
8
8
 
9
9
  # Review
@@ -3,7 +3,7 @@ name: spec
3
3
  description: "Writes software design specs from already-clarified requirements, including solution approach, architecture outline, detailed design, tradeoffs, verification design, and handoff context. Not for unresolved requirements, PRD generation, implementation task planning, or code changes."
4
4
  when_to_use: "spec, design spec, technical design, design proposal, detailed design, architecture design, 设计方案, 概要设计, 详细设计, 技术方案"
5
5
  metadata:
6
- version: "0.2.3"
6
+ version: "0.2.7"
7
7
  ---
8
8
 
9
9
  # loopx Spec
@@ -3,7 +3,7 @@ name: subagent-exec
3
3
  description: "Executes approved loopx implementation plans with fresh subagents per independent task and staged review. Not for planning, unclear requirements, or tightly coupled edits."
4
4
  when_to_use: "approved implementation plan, independent tasks, subagent execution, staged spec review, code quality review, parallel-capable execution"
5
5
  metadata:
6
- version: "0.2.3"
6
+ version: "0.2.7"
7
7
  ---
8
8
 
9
9
  # Subagent Exec
@@ -63,11 +63,13 @@ digraph process {
63
63
  "Mark task complete in update_plan" [shape=box];
64
64
  }
65
65
 
66
+ "Record finish baseline with loopx finish-start <slug> --source <plan-path>" [shape=box];
66
67
  "Read plan, extract all tasks with full text, note context, create update_plan" [shape=box];
67
68
  "More tasks remain?" [shape=diamond];
68
69
  "Use loopx:final-review for entire implementation" [shape=box];
69
70
  "Use loopx:finish" [shape=box style=filled fillcolor=lightgreen];
70
71
 
72
+ "Record finish baseline with loopx finish-start <slug> --source <plan-path>" -> "Read plan, extract all tasks with full text, note context, create update_plan";
71
73
  "Read plan, extract all tasks with full text, note context, create update_plan" -> "Dispatch implementer subagent (./implementer-prompt.md)";
72
74
  "Dispatch implementer subagent (./implementer-prompt.md)" -> "Implementer subagent asks questions?";
73
75
  "Implementer subagent asks questions?" -> "Answer questions, provide context" [label="yes"];
@@ -89,6 +91,16 @@ digraph process {
89
91
  }
90
92
  ```
91
93
 
94
+ ### Step 0: Record Finish Baseline
95
+
96
+ Before dispatching the first implementer, run:
97
+
98
+ ```bash
99
+ loopx finish-start <slug> --source <plan-path>
100
+ ```
101
+
102
+ Use the plan filename slug when no workflow slug is available. This preserves the starting `HEAD` so `finish-audit` can inspect `baseline..HEAD` even after implementers commit their work and the current `git diff` is empty.
103
+
92
104
  ## Model Selection
93
105
 
94
106
  Use the least powerful model that can handle each role to conserve cost and increase speed.
@@ -3,7 +3,7 @@ name: tdd
3
3
  description: "Guides feature and bugfix implementation through a failing test before production code and red-green-refactor discipline. Not for generated files or throwaway prototypes."
4
4
  when_to_use: "tdd, failing test first, feature implementation, bugfix, regression test, red green refactor, 测试先行"
5
5
  metadata:
6
- version: "0.2.3"
6
+ version: "0.2.7"
7
7
  ---
8
8
 
9
9
  # Test-Driven Development (TDD)
@@ -3,7 +3,7 @@ name: verify
3
3
  description: "Requires fresh verification evidence before claiming work is complete, fixed, passing, review-ready, or ready to commit. Not for speculative confidence or stale results."
4
4
  when_to_use: "verify, completion claim, fixed claim, tests pass, review-ready, commit, fresh evidence, 验证, 完成前检查"
5
5
  metadata:
6
- version: "0.2.3"
6
+ version: "0.2.7"
7
7
  ---
8
8
 
9
9
  # Verification Before Completion